Skip to main content
Collection configuration controls everything about how a collection appears and behaves in Forest, from its name and icon to which fields are searchable, how records are sorted by default, and what actions are available. Most settings are configured visually through the Layout Editor or the collection’s Settings panel.

Collection settings

Access collection settings by entering Layout Editor mode and clicking the ⚙️ gear icon next to a collection name in the sidebar.
SettingDescription
Display nameThe label shown in the navigation and throughout the UI
IconAn icon to identify the collection visually
DescriptionA short note shown to operators to explain what this collection contains
VisibilityControl whether the collection appears in the navigation

Table view configuration

The table view is the primary way operators browse records. Configure it to show the right information at a glance:
  • Column selection, choose which fields appear as columns
  • Column ordering, set the left-to-right order of columns
  • Column width, adjust how much space each column takes
  • Default sort, define which field is sorted by default and in which direction
  • View density, switch between compact and comfortable row height
These settings are managed in the Layout Editor.

Record display

When an operator clicks a record to open it, Forest shows a detail view. Configure:
  • Summary field, which field value appears in breadcrumbs and relationship pickers (typically a name or identifier)
  • Related collections, which HasMany relationships appear in the detail view and in what order
To set the summary field, go to collection settings and select a field from the “Record title” dropdown.

Segments

Segments are pre-filtered views of a collection, like “Active users”, “Pending orders”, or “High-risk transactions”. Operators can switch between segments from the collection’s navigation bar. Configure segments in the Segments tab of the collection settings:
  • Create a segment, define a filter condition (no-code) or write a Smart Segment (code)
  • Reorder segments, drag to set the display order
  • Set a default segment, the segment that loads when the collection is opened
  • Segment permissions, control which teams can see each segment
See Creating Segments for details on building segment conditions.

Filters

Operators can filter collection records using the filter panel. Configure:
  • Available filters, which fields appear as filter options
  • Filter presets, saved filter combinations that operators can apply in one click
Filter presets are shared across the team. Create them by applying a filter in the collection view and clicking Save filter.

Actions configuration

Actions are buttons that operators can trigger on records. In collection settings, control:
  • Action visibility, show or hide specific actions for this collection
  • Action ordering, set the display order in the action menu
  • Action permissions, managed through Roles & Permissions
Both built-in actions (create, edit, delete, export) and actions appear here.