Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Layouts in DX API

Updated on February 7, 2022

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.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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