Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Enable configuration of components with inherited controllers in component builder

Learn how components can inherit page resources.

Using component builder, developers add data resources in two ways: directly within the component or through inheritance from the page.

Direct configuration

When you add data resources directly to a component, they remain contained within that component. These internal data resources are not visible or accessible when the component is placed on a page.

Inheritance

You can configure a component to inherit data resources from the page where it's placed. When inheritance is enabled, the component scans for data resources of the same type and automatically connects to them. For example, a component configured to inherit form controllers will look for form controllers on the page. This allows the component to be used across different page contexts and leverage existing data resources without manual configuration each time.

When you place a component configured for inheritance on a page, the inheritance behavior works as follows:

Matching resources foundBehavior
No match foundCreates a new resource of the same type using the component's initial configuration
OneConnects to that resource
MultipleConnects to the first instance of that resource

Parent Topic:Component Builder

Enable configuration of components with inherited controllers

Configure components to automatically inherit controllers and data resources when placed on pages.

Before you begin

Role required: ui_builder_admin

About this task

In this Component Builder example, we will create a text component and configure it to inherit the List controller. We will then place it on an list page where the component connects to the List controller and displays the appropriate table name.

Procedure

  1. Navigate to All > Now Experience Framework > UI Builder.

  2. Select Create from the UI Builder home page.

Image omitted: create-component-button.png
UI Builder home page with the Create component button.
  1. Select Component.

  2. In the form, enter the following values:

    FieldValue
    NameTable Reference
    CategoriesContent
    DescriptionText component that displays the name of the current page's table
    Icon(Default)
  3. Select Create.

  4. Add a data resource to the component.

    1. In the data resource drawer, select + Add data resource.

    2. On the left, select List Controller.

    3. On the right, select Advanced configurations to expand the section.

    4. Select the Inherit configurations from parent option to enable the property.

    5. Select Add.

Image omitted: inherit-controllers-inherit.png
Select a data resource modal with List controller selected and Inherit configurations from parent enabled.
  1. Create the component.

    1. In the content tree, select + Add content.

    2. Select Single column, then select Add.

    3. In the content tree, select + Add content under Column 1.

    4. Select a Stylized text, then select Add.

    5. Select Cancel to close the preset window.

  2. Configure the component to use the List controller.

    1. In the configuration panel, hover over Text and select the bind data
Image omitted: data-icon.png
icon.
2.  On the left, select the **Formulas** tab, then double-click **CONCAT**.

3.  In the upper section, double-click **value1** to edit the field and enter `"List showing records from "`.

4.  Double-click **values** to edit the field and enter `@data.list_controller_1.tableLabel`.

5.  Select **Apply**.
  1. Select Save to save your work.

    Your custom component is now available in the toolbox and ready for use in a page.

  2. Place the component on a list page to see it automatically inherit the List controller and display the table name.

Image omitted: inherit-controllers-result.png
UI Builder editor showing custom component inheriting the list controller and displaying the table name.