Skip to main content

Layouts in DX API

Suggest edit Updated on July 21, 2021

Understand how you can organize your custom user interface with REST API by learning how layouts are supported in V1 Pega DX API.

For example, you can use DX API to organize UI elements within a screen that users interact with when they create a bug report in a sample application.
Layouts organize UI elements within a screen. In RESTful API, top-level groups arrays contain only one element that is a layout, as in the following example:

The layout element that the API call returns corresponds to the top layout of the section that you're currently customizing.

The supported layouts return the following values in the layoutFormat parameter:

  • Screen layouts return the SCREENLAYOUT value for the top-level pages.
  • Dynamic layouts return the SIMPLELAYOUT value.
  • Repeating dynamic layouts return the REPEATINGROW value.
  • Tables return the TABLELAYOUT value.
Note: The groupFormat value that defines the group formatting depends on the type of the layout.

The following example of an API response shows a Bug layout and a Followers layout in two layout elements under groups:

Note that Pega DX API does not support the following layouts:

  • Column layouts
  • Layout group
  • Dynamic layout groups
In terms of structure and organization of content, Pega DX API also does not support the following elements:
  • Containers
  • Non-auto-generated sections
  • Sections that include scripts
  • Non-guardrail-compliant sections

For more information about supported layouts, see the starter pack documentation on the Pega Digital Experience (DX) API page on Pega Community.

Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us