
Properties and settings
Settings (applicable across all platforms)
These settings added in the Generic tab are available and they apply to all platforms including Web, iOS, and Android.When used as root
When the Card is utilized as the root component, it offers the following settings:- Custom UI payload: A valid JSON describing the custom data transmitted to the frontend when the process reaches a specific user task.
- Title: The title displayed on the card.
- Subtitle: Additional descriptive text accompanying the card.
- Has accordion: Shows the card as a collapsible panel. The title and subtitle stay visible in the header, and users expand or collapse the content.
Has accordion is available on every platform tab. Default state is shown only for a card that isn’t the root, because a root card always loads expanded. On iOS and Android, only a card that isn’t the root can be collapsed.
Mobile configuration (iOS & Android)
For mobile configuration (iOS and Android), you can also configure the following property (not available on Web configuration):- Screen title: Set the screen title used in the navigation bar on mobile devices (available only when the card element is set as the root).

Android Card Screen Title
Card settings overrides
You may want to override the card title or subtitle set as Generic to be displayed differently on mobile devices. For example, on the web, titles might be shorter.- Web
- Android
- iOS
Available properties overrides for web (overriding properties set in Generic settings tab):
- Title
- Subtitle
- Has Accordion
- Default state
- Hide (under Expressions)

When not used as root
When the card is not the root, you can configure: Title, Subtitle, Has accordion, and Default state. Default state appears when Has accordion is on for the current platform, and sets whether the card loads Expanded (default) or Collapsed. A root card has no Default state setting. Use cards in your designs to organize and present content, enhancing the overall user experience.Styling
- Web
- iOS
- Android
- Layout
- Sizing
When designing for the web, consider the layout options available for the card. These options include:
- Direction: Choose between Horizontal or Vertical alignment to define the flow of components. For example, select Horizontal for a left-to-right layout.
- Justify: Specify how content is aligned along the main axis. For instance, select end to align items to the end of the card.
- Align: Align items on the cross axis: start, center, end, or stretch.
- Wrap: Enable wrapping to automatically move items to the next line when they reach the end of the card. Useful for creating multi-line layouts.
- Gap: Define the space between components to control the distance between each item. Adjusting the gap enhances visual clarity and organization.
Theme overrides
Customize the appearance by overriding style options coming from your default theme. Available overrides:- Border Width
- Border Radius
- Border Color
- Background Color
- Shadow
- Title
- Title Color
- Subtitle
- Subtitle Color
Layout Demos
Validating elements
To ensure the validation of all form elements and custom components within a card upon executing a Save Data action such as Submit or Continue, follow these steps:- When adding an event handler to a button inside a card, select the Add forms to submit checkbox.
- From the Select forms to submit dropdown that appears, select the specific forms, individual form elements, or custom components you wish to validate.
- If you select custom components, ensure they are properly configured to handle validation and data saving responsibilities.

Custom component validation
Event handlers enable validation and data management for custom components alongside form elements. This provides flexibility if you want to design custom components for entire screens, such as custom forms not natively supported by the platform.
Key features
- Validation API: The renderer provides a public API for validating custom components before triggering an action.
- Custom Component Responsibilities:
- Listen to
validated$, which emits when the forms are submitted, then callvalidate(true)for valid data orvalidate(false)for invalid data. - Display validation errors in the UI for invalid data.
- Call
saveData(...)with the structured data to be submitted.
- Listen to
- Configurator Responsibilities:
- Select custom components in the Select forms to submit dropdown when configuring an event handler.
- Set the custom key to store the data submitted by the custom component.


