How to Customize Object Forms with Custom Fields and Screens
Admin guide
This page is for administrators with write access to Custom Fields and Custom Screens.
What is it?
Custom Fields and Custom Screens work as a pair to extend object registration with your own metadata:
- A custom field is a typed input (text, number, date, select, file) you define once and attach to one or more object types.
- A custom screen is the layout for one object type: it arranges custom fields into named sections on a grid.
Both live under Settings. Define fields first, then lay them out on a screen.
Before you start
- You need write access to Custom Fields and Custom Screens.
- Decide which object types the field applies to (Model, Policy, Feature, and so on).
Part 1: Define Custom Fields
Step 1: Open Custom Fields
Go to Settings → Custom Fields. Click + New Custom Field.
Step 2: Choose how the field is managed and its type
| Field | What to enter |
|---|---|
| NameRequired | The field's display name. |
| ManagedRequired | Within Corridor (users fill it in the platform) or By External System (populated from outside). External-managed fields cannot be the Single File type. |
| Field TypeRequired | One of Number, Short Text, Long Text, Single Select, Multiple Select, Single File (Corridor-managed only), or Datetime. |
Step 3: Configure field properties
| Property | What it does |
|---|---|
| AliasRequired | A valid variable name used to reference the field. |
| Object TypesRequired | Which object types can use this field. |
| Is Mandatory | Makes the field required during registration. |
| Is Searchable | (Text, Number, Select fields) Lets users search on the field's value. |
| Is Editable After Approval | (Corridor-managed) Allows edits after the object is approved. |
| Options | (Single/Multiple Select) The selectable values; add and remove rows. |
| Default Value | (Number, Short/Long Text) A pre-filled value. |
| Placeholder Text / Help Text | Input hint and tooltip. |
| Description | What the field documents. |
Click Save.
Part 2: Lay Out a Custom Screen
A custom screen is per object type: each object type has one screen.
Step 1: Open Custom Screens
Go to Settings → Custom Screens and open (or create) the screen for the object type you want to customize. The screen's name is the object type.
Step 2: Add sections and place fields
- Click Add Section to create a named group. Sections render top to bottom in their sort order.
- From the right-hand sidebar (custom fields grouped by type, with a search box), click a field to add it to the expanded section.
- Drag fields to reposition them on the 4-column grid. Resize a field from its right edge: full width (4 columns), three-quarters (3), half (2), or quarter (1).
- Use the trash icons to remove a field or a section (you must keep at least one section).
- Need a field that doesn't exist yet? Use Add Custom Field in the sidebar to create one inline; it appears in the sidebar after saving.
Step 3: Save
Save the screen. Field positions are normalized on save so there are no gaps, and the layout takes effect on that object type's detail page.
Note
Only Corridor-managed fields appear in the sidebar for placement. Fields already on the screen are hidden from the sidebar.
What's next
- The fields you define here appear when users register objects.
- Use Roles Collection filters with field-based scoping where supported.