Skip to main content

Header Widget

The Header widget displays one or more field values from the current record as a large, prominent heading at the top of a layout. Unlike the Text block - which shows fixed text you type in the editor - the Header widget is dynamic. Its content comes from the record being viewed, so it shows a different value for every record. This makes it ideal for giving each record page a clear, recognizable title.

When to use it

  • Displaying a contact's full name at the top of a contact detail page, so users always know whose record they're viewing.
  • Showing a project name as the heading on a project detail layout.
  • Displaying an invoice number or order number prominently at the top of a transaction record.
  • Combining multiple fields - like first name and last name - into a single heading.
  • Showing a product name or company name at the top of its respective detail page.

How to configure it

  1. Open the layout editor for the detail or view layout where you want the heading.
  2. Click Add Block at the top of the layout.
  3. Select Widget from the block type list, then choose Header .
  4. In the Header settings, enter the field name(s) you want to display in the Heading Fields input.
  5. To combine multiple fields (e.g. first name and last name), enter both field names separated by commas: first_name, last_name .
  6. The fields will be displayed in the order you list them, with a space between each.
  7. Save and publish your layout.
You can combine multiple fields in the Header by separating them with commas. For example, entering first_name, last_name will display the contact's full name as a single heading - "Jane Smith" - pulling live values from the record.

Example

You have a contact detail layout that shows all the information about a specific contact. Without a Header widget, the page has no title - users have to look at the Name field midway down the form to know whose record they're on. You add a Header widget at the very top of the layout and configure it with first_name, last_name . Now every contact detail page opens with the person's full name displayed large at the top - "Michael Torres", "Sarah Chen", "David Patel" - making it immediately clear which record is open.

Tips

  • Use the field's internal name (the slug or key used in the database), not the display label. You can find this in your object type's field settings.
  • For objects where the primary identifier is a single field (like a project name or invoice number), entering just that one field is enough.
  • Place the Header widget at the very top of the layout, before any other blocks, so it serves as the page title for the record.