Creating and Managing Active Pages
This page covers the administrative work of managing Active Page records: creating a new entry, editing its metadata, opening the IDE, deleting, and cloning. The IDE itself, the markup language, the component library, and all code-level material are documented in the Developer Guide.
Requirements
- Administrator System Role.
- If you will attach a Controller to the page, the corresponding Active Class should already exist (or you can create it later and attach it).
Open the Pages List
- From the Setup home page, go to Develop > Pages.
- The list shows every Active Page in the portal with its Label, Name, Type, Version, and last-modified-by metadata.
Create an Active Page
- From the list, click New.
- Fill in the page properties:
- Label — the human-readable name that appears in admin lists. Up to 120 characters.
- Name — the API name used in code and URLs. Must start with a letter and contain only letters, digits, and underscores. No spaces or special characters.
- Type — Active Page (the default), Active Template (a reusable layout fragment), or Active Content (a content fragment used inside other containers).
- Version — pick a framework version (2.0, 3.0, 4.0, or 5.0). Newer versions have more components and improved rendering. Choose the latest version unless you have a specific reason to target an older one.
- Description — an internal note describing the page's purpose. Up to 512 characters.
- Controller — optionally attach an Active Class as the page's Controller. Only Active Classes of type Controller appear in this lookup.
- Test URL — optional. When set, the IDE's preview uses this URL instead of the default page URL.
- Click Save. The page is created with default starter content. You are now on the page's detail view.
Open the IDE
From the page's detail view, click the kebab menu (three dots) and select Edit. The IDE opens with the page's markup. The IDE supports syntax highlighting, compilation feedback, and saves changes back to the Active Page record.
Authoring inside the IDE is a developer activity. See the Developer Guide for the framework introduction, ActivePages Properties and Features for the available components, and Controllers Overview for the request handling pattern.
Mobile and Tablet Content
The page record stores three content variants:
- Content — the desktop default. Always populated.
- Mobile Content — an optional override served on mobile devices.
- Tablet Content — an optional override served on tablets.
If a variant is empty, the desktop Content is served. To add a Mobile or Tablet variant, open the IDE; the IDE exposes the variants as separate editable buffers.
Edit Page Metadata
To change Label, Description, Type, Version, attached Controller, or Test URL without entering the IDE:
- From Setup > Develop > Pages, open the Active Page.
- Click the kebab menu (three dots) and select Edit Settings (or use the Edit action depending on the version).
- Modify the fields and click Save.
The page's Name cannot be changed after creation if the page is referenced by code; renaming a referenced page would break those references.
Clone an Active Page
To create a similar page quickly:
- From Setup > Develop > Pages, open the Active Page you want to clone.
- Click the kebab menu and select Clone.
- The new page opens with a copy of the original's Content, Mobile Content, Tablet Content, Type, Version, and Controller. Provide a new Name and Label.
- Click Save.
Cloning does not copy sharing settings. The cloned page starts with admin-only access; configure sharing separately.
Delete an Active Page
- From Setup > Develop > Pages, open the Active Page.
- Click the kebab menu and select Delete.
- Confirm in the dialog.
Before deleting, audit anywhere the page may be referenced — navigation Menu Items, Engagement Pages with Active Page widgets, links inside other Active Pages, and any external URLs to the page. The platform does not automatically clean up these references.
Share an Active Page
Sharing is configured from the page's detail view via the Share dialog. The dialog supports Roles, User Groups, and specific people. The full sharing model, including Guest Role behavior, is documented in Sharing Active Pages and Classes.
Troubleshooting Tips
- If a page won't save because the Name is invalid, verify it starts with a letter and contains only letters, digits, and underscores.
- If the Controller dropdown doesn't list your Active Class, confirm the Active Class is of type Controller. Other class types are not eligible.
- For visibility and access symptoms, see Active Pages Troubleshooting.
<< Active Pages and Classes Checklist | Creating Active Classes >>