FlexiPage

Represents a Lightning page. A Lightning page is a customizable page composed of regions containing Lightning components.

Includes access to the associated FlexiPage object in the Metadata API. Available from API version 31.0 or later.

Lightning pages are used in several places.

In the Salesforce app, a Lightning page is the home page for an app that appears in the navigation menu.
In Lightning Experience, Lightning pages can be used:
- To customize the layout of record pages, the Salesforce Home page, and the Email Application pane in the Outlook and Gmail integrations.
- As the home page for an app.
- As the utility bar for a Lightning app.

These pages are known as FlexiPages in the API, but are referred to as Lightning pages in the rest of the Salesforce documentation and UI.

Note

Supported SOAP Calls

create(), delete(), describeLayout(), describeSObjects(), query(), retrieve(), update(), upsert()

Supported REST HTTP Methods

GET, HEAD

Fields

Field	Details
Description	Type string Properties Filter, Group, Nillable, Sort Description The page description. This field can be useful to describe the reason for creating the page or its intended use.
DeveloperName	Type string Properties Filter, Group, Sort Description The API name of the Lightning page.
EntityDefinitionId	Type string Properties Filter, Group, Nillable, Sort Description The name of the standard object or ID of the custom object that the Lightning page is associated with. For Lightning pages of type `AppPage` or `HomePage`, this field is `null`. This field is available in API version 39.0 and later.
FullName	Type string Properties Create, Group, Nillable Description The full name of the associated FlexiPage object in Metadata API. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
ManageableState	Type ManageableState enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the manageable state of the specified component that is contained in a package: `beta` `deleted` `deprecated` `deprecatedEditable` `installed` `installedEditable` `released` `unmanaged` This field is available in API version 38.0 and later.
MasterLabel	Type string Properties Filter, Group, Sort Description The page’s label.
Metadata	Type FlexiPageMetadata Properties Create, Nillable, Update Description Lightning page metadata. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
NamespacePrefix	Type string Properties Filter, Group, Nillable, Sort Description The namespace of the package of which the flexipage is a part.
ParentFlexiPage	Type string Properties Filter, Group, Nillable, Sort Description The name of the FlexiPage that this page inherits behavior from. Available in API version 37.0 or later.
SobjectType	Type string Properties Filter, Group, Nillable, Sort Description The object the Lightning page is associated with. For Lightning pages of type `AppPage` or `HomePage`, this field is `null`. Available in API version 37.0 and 38.0. Deprecated as of API version 39.0. Use EntityDefinitionId instead.
Type	Type picklist Properties Filter, Group, Restricted picklistSort Description Required. The type of the Lightning page. Valid values are: `AppPage`—A Lightning page that is used as the home page for a custom app. `CommAppPage`—A Lightning page that is used to represent a custom page, as created in the Experience Builder, in Communities. This value is available in API version 37.0 and later. `CommFlowPage` A Lightning page used to override a flow page, as created in the Experience Builder, in Communities. This value is available in API version 45.0 and later. `CommForgotPasswordPage`—A Lightning page that’s used to override a forgot-password page, as created in Experience Builder, in Communities. This value is available in API version 39.0 and later. `CommFlowPage`—An out-of-the-box flow page, as created in Experience Builder, in Communities. This value is available in API version 45.0 and later. `CommGlobalSearchResultPage` A Lightning page used to override the global search result page, as created in Experience Builder, in Communities. This value is available in API version 41.0 and later. `CommLoginPage`—A Lightning page that’s used to override the login page, as created in Experience Builder, in Communities. This value is available in API version 39.0 and later. `CommNoSearchResultsPage`—A Lightning communities page for B2B searches that return no results. The URL for this page is no-results/:term. The page starts out empty. You can add any component to it that accepts parameters to achieve the desired “no results” experience. For example, you can place an HTML Editor component or CMS components for recommendations, banners, help and support. This value is available in API version 48.0 and later. `CommObjectPage`—A Lightning page used to override an object page, as created in Experience Builder, in Communities. This value is available in API version 38.0 and later. `CommQuickActionCreatePage`—A Lightning page used to override the create record page, as created in Experience Builder, in Communities. This value is available in API version 38.0 and later. `CommRecordPage`—A Lightning page used to override a record page, as created in the Experience Builder, in Communities. This value is available in API version 38.0 and later. `CommRelatedListPage`—A Lightning page used to override a related list page, as created in the Experience Builder, in Communities. This value is available in API version 38.0 and later. `CommSearchResultPage`—A Lightning page used to override the search result page, as created in Experience Builder, in Communities. This value is available in API version 38.0 and later. `CommSelfRegisterPage`—A Lightning page used to override the self-registration page, as created in Experience Builder, in Communities. This value is available in API version 39.0 and later. `CommThemeLayoutPage`—A Lightning page used to override a theme layout page, as created in the Experience Builder, in Communities. This value is available in API version 38.0 and later. `EmbeddedServicePage` This value is available in API version 45.0 and later. `EmailTemplatePage` — a page that contains the builder markup for your email template. When you edit an email template in the builder, the FlexiPage object remembers where you put the components. This value is reserved for future use. `HomePage`—A Lightning page that is used to override the Home page in Lightning Experience. This value is available in API version 37.0 and later. `MailAppAppPage`—An email application pane used to override the default layout in the Outlook and Gmail integrations. This value is available in API version 38.0 and later. `RecordPage`—A Lightning page used to override an object record page in Lightning Experience. This value is available in API version 37.0 and later. `RecordPreview` A Lightning page used to override standard lookup previews when hovering over previewable records in Lightning Experience.This value is available in API version 45.0 and later. `UtilityBar`—A Lightning page used as the utility bar in Lightning Experience apps. This value is available in API version 38.0 and later. Available in API version 32.0 or later. In API versions 32.0 through 36.0, this field can only have a value of `AppPage`.

Sample Code

This code sample creates a Lightning page with a single Recent Items component, that shows recently used Accounts and MyCustomObject__cs

1ComponentInstance recentItems = new ComponentInstance();
2 recentItems.setComponentName("flexipage:recentItems");
3 ComponentInstanceProperty cip = new ComponentInstanceProperty();
4 cip.setName("entityNames");
5 cip.setValue("Account,MyCustomObject__c");
6 recentItems.setComponentInstanceProperties(new ComponentInstanceProperty[]{cip});
7
8FlexiPageRegion mainRegion = new FlexiPageRegion();
9mainRegion.setName("main");
10mainRegion.setType(FlexiPageRegionType.Region)
11mainRegion.setComponentInstances(new ComponentInstance[] { recentItems });
12
13FlexiPageMetadata fpMetadata = new FlexiPageMetadata();
14fpMetadata.setFlexiPageRegions(new FlexiPageRegion[]{mainRegion});
15fpMetadata.setMasterLabel("My FlexiPage");
16fpMetadata.setDescription("A FlexiPage with a recent items component");
17fpMetadata.setType(FlexiPageType.AppPage);
18
19FlexiPage flexiPage = new FlexiPage();
20flexiPage.setFullName("MyFlexiPageDevName");
21flexiPage.setMetadata(fp);
22
23// Create
24SaveResult saveResult = soapConnection.create(new SObject[] { flexiPage });

Tooling API

FlexiPage

Supported SOAP Calls

Supported REST HTTP Methods

Fields

Sample Code