Composite
A Composite field is a container that groups multiple related sub-fields into one. Instead of adding separate fields for related pieces of data, a composite field bundles them together - keeping your object type organized and your forms clean.
What it is
A Composite field acts as a wrapper around a set of sub-fields that logically belong together. The sub-fields each have their own label, type, and settings, but they're presented and managed as a single unit in your object type. The Address field is the primary built-in example - it groups Address Line 1, City, State, and Zip Code into one composite field rather than four separate standalone fields.
When to use it
- Addresses - the classic example; street, city, state, and zip belong together
- Names with parts - first, middle, and last name as a single composite rather than three loose fields
- Contact info sets - phone number, email, and preferred contact method grouped on a record
- Measurements or specifications - width, height, and depth stored together on a product record
- Any structured data that has multiple parts - when the parts only make sense together
Benefits
- Streamlined data entry - users fill out a single grouped section instead of hunting through unrelated fields
- Better organization - your object type's field list stays tidy when related fields are bundled
- Custom layout of sub-fields - you control how the sub-fields are arranged within the composite group
- Easier to reason about - seeing "Address" as one field is clearer than seeing four separate fields scattered in a list
Settings
- Label - the name shown for the composite group in forms and layouts
- Sub-fields - add, remove, and configure the individual fields inside the composite
- Required - can be set per sub-field within the composite
- Conditional - show or hide the entire composite based on another field's value
Example
In a wholesale order management app, you add a Composite field to your Orders object type for Shipping Address . Inside the composite you configure sub-fields for Address Line 1, Address Line 2, City, State, and Zip Code. On the order form, these five fields appear together as a single grouped section labeled Shipping Address - keeping the form organized and making it obvious to your team that all five fields refer to the same delivery location.