FlexiPage | Metadata API Developer Guide

Represents the metadata associated with a Lightning Page. A Lightning Page is the home page for an app that appears as a menu item in the Salesforce1 navigation menu. This type extends the Metadata metadata type and inherits its fullName field.

These app 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

For more information on Lightning Pages, see the Salesforce Help.

The FlexiPage component is supported only in Salesforce1. For more information about Salesforce1, see the Salesforce Help.

Note

File Suffix and Directory Location

FlexiPage components have the suffix .flexipage and are stored in the flexipages folder.

Version

FlexiPage components are available in API version 29.0 and later.

Fields

Field Name	Field Type	Description
description	string	The optional description text of the Lightning Page.
flexiPageRegions	FlexiPageRegion[]	Required. The list of regions of a page.
masterLabel	string	Required. The label for this FlexiPage, which displays in Setup.
pageTemplate	string	Required. The template associated with the FlexiPage. This field is available in API version 33.0 or later.
parentFlexiPage	string	This field is reserved for future use. This field is available in API version 35.0 or later.
platformActionList	PlatformActionList	The list of actions, and their order, that display in the Salesforce1 action bar for the Lightning Page. This field is available in API version 34.0 and later.
quickActionList	QuickActionList	The list of quick actions associated with the Lightning Page.
sobjectType	string	This field is reserved for future use. This field is available in API version 33.0 or later.
type	FlexiPageType (enumeration of type string)	Required. The type of a page. In API version 32.0, this field can only have a value of `AppPage`. Valid values are: `AppPage`—A Lightning Page used as the home page for a custom app. This field is available in API version 32.0 and later.

FlexiPageRegion

FlexiPage Region represents the properties of a region of a page. A region can contain a record list component or a recent items component that can be scoped to a set of entities.

Field Name	Field Type	Description
appendable	RegionFlagStatus (enumeration of type string)	This field is reserved for future use. Valid values are: `disabled` `enabled` This field is available in API version 35.0 or later.
componentInstances	ComponentInstance[]	Properties and name of the component instance.
mode	FlexiPageRegionMode (enumeration of type string)	This field is reserved for future use. Valid values are: `Append` `Prepend` `Replace` This field is available in API version 35.0 or later.
name	string	Required. Unique name of the FlexiPage region.
prependable	RegionFlagStatus (enumeration of type string)	This field is reserved for future use. Valid values are: `disabled` `enabled` This field is available in API version 35.0 or later.
replaceable	RegionFlagStatus (enumeration of type string)	This field is reserved for future use. Valid values are: `disabled` `enabled` This field is available in API version 35.0 or later.
type	FlexiPageRegionType (enumeration of type string)	Required. The type of FlexiPage region. Valid values are: `Facet` `Region` This field is available in API version 35.0 or later.

ComponentInstance

Instance of a component in a page, such as a filter list.

Field Name	Field Type	Description
componentInstanceProperties	ComponentInstanceProperty[]	The value of a single property in a component instance. A component instance can have no properties.
componentName	string	Required. The name of a single instance of a component.

ComponentInstanceProperty

Value of a single property in a component instance.

Field Name	Field Type	Description
name	string	Name of the property, unique within the component instance.
value	string	Reference or value of the property.

When you give a standard label to a tab in a Tabs component—such as Activity, Collaborate, or Details—and when the name field is set to title, the value field uses a system-defined value instead of the label.

Standard.Tab.activity
Standard.Tab.collaborate
Standard.Tab.detail
Standard.Tab.feed
Standard.Tab.preview
Standard.Tab.relatedLists

For example, let’s say you have a Lightning Page that contains a tab with the standard label “Activity”. If you query the definition that page, you see the system-defined name of the tab, not the label, in value.

PlatformActionList

PlatformActionList represents the list of actions, and their order, that display in the Salesforce1 action bar for the layout. Available in API version 34.0 and later.

Field Name	Field Type	Description
actionListContext	PlatformActionListContext (enumeration of type string)	Required. The context of the action list. Valid values are: `BannerPhoto` `Chatter` `Dockable` `FeedElement` `FlexiPage` `Global` `ListView` `ListViewDefinition` `ListViewRecord` `Lookup` `MruList` `MruRow` `ObjectHomeChart` `Photo` `Record` `RecordEdit` `RelatedList` `RelatedListRecord`
platformActionListItems	PlatformActionListItem[]	The actions in the PlatformActionList.
relatedSourceEntity	string	When the ActionListContext is RelatedList or RelatedListRecord, this field represents the API name of the related list to which the action belongs.

PlatformActionListItem

PlatformActionListItem represents an action in the PlatformActionList. Available in API version 34.0 and later.

Field Name	Field Type	Description
actionName	string	The API name for the action in the list.
actionType	PlatformActionType (enumeration of type string)	The type of action. Valid values are: `ActionLink`—An indicator on a feed element that targets an API, a web page, or a file, represented by a button in the Salesforce Chatter feed UI. `CustomButton`—When clicked, opens a URL or a Visualforce page in a window or executes JavaScript. `InvocableAction` `ProductivityAction`—Productivity actions are predefined by Salesforce and are attached to a limited set of objects. You can’t edit or delete productivity actions. `QuickAction`—A global or object-specific action. `StandardButton`—A predefined Salesforce button such as New, Edit, and Delete.
sortOrder	int	The placement of the action in the list.
subtype	string	The subtype of the action. For quick actions, the subtype is `QuickActionType`. For custom buttons, the subtype is `WebLinkTypeEnum`. For action links, subtypes are `Api`, `ApiAsync`, `Download`, and `Ui`. Standard buttons and productivity actions have no subtype.

Declarative Metadata Sample Definition

Here’s a sample XML FlexiPage component definition for a travel app that tracks the user’s trips, expense reports, and other relevant data:

And, here’s the sample package.xml file that references the FlexiPage component definition: