Skip to main content
Version: 0.10

Layouts

A layout decides how assets of one type are presented. Each asset type has two layouts per tenant:

LayoutShapesStructure
Detailed (detail page layout)The asset page: its tabs, the sections on each tab and the fields in each sectionAny number of tabs, each with sections placed on a 12-column grid
Creation (creation form layout)The Create asset form: which fields it asks for, in which orderOne tab with one full-width section

Layouts belong to the tenant: a change applies to everyone who opens assets of that type in the tenant. Each new tenant starts with a default pair for every asset type.

Permissions​

Opening the layouts needs Layouts Read; saving a change needs Layouts Write. Someone without Layouts Read still sees asset pages, but as a single General tab listing every field with a value, and the create form falls back to the list's default columns. See Roles and permissions.

The Layouts screen​

Settings → Layouts lists the asset types with their Key and Description. Click a type to open its detail layout in the editor, or use the row actions Edit <type> detail layout and Edit <type> creation layout.

The layout editor​

The editor opens full screen. The top bar shows the asset type and which layout you are editing (Detail page layout or Creation form layout), with Detailed and Creation tabs to switch between the two, and Layouts to go back. If you leave with unsaved work, the console asks before discarding it (Discard and leave or Keep editing).

The screen has two parts:

  • The field palette on the left lists the tenant's whole field dictionary, grouped by origin (Core, Standard, Custom, Scripted, Cached, then one group per integration) and searchable with Search fields…. Fields already placed on the current tab are marked. Add section is at the top of the palette.
  • The canvas on the right shows the layout's tabs and the current tab's sections on a 12-column grid.

Working with tabs (detail layout)​

  • Add tab creates a tab. Its name is what the asset page's tab bar shows.
  • A tab's menu offers Rename tab, Move left, Move right and Delete tab. Tabs can also be dragged into a new order.
  • A layout must keep at least one tab. Deleting a tab removes it and its sections from the layout; the fields stay in the dictionary.

Working with sections (detail layout)​

  • Add section places a new section on the current tab.
  • Drag a section to move it, and drag its resize handle to change its width (in twelfths of the page) and its height (in grid rows).
  • Drag fields from the palette into a section, drag them to reorder or into another section, and remove them from a section. A section shows each field once; the same field can be placed in more than one section.
  • Section settings sets the Section name (the card heading on the asset page) and Show empty fields. With it off, fields with no value are hidden on the asset page, and the section is flagged in the editor.
  • Deleting a section removes it and its field placements; the fields stay available in the palette.

A field the layout names but the tenant no longer has is shown as an unknown field, which you can remove. On the asset page it is simply skipped.

The creation layout​

The creation layout is a single flow: one tab and one section that always spans the full width. Tabs cannot be added, renamed or deleted, and the section name is fixed. The palette offers only fields a value can be typed into (Standard and Custom fields, except File), since no other field could appear on the form.

The order of the fields in the section is the order of the form. The asset's name field always comes first on the form, whether or not the layout lists it.

Saving​

Changes are a draft until you choose Save layout. Discard throws the draft away. Unsaved changes and Saved show the state.

LimitValue
Tabs per layout1 to 50, each with a unique name
Sections per tabUp to 100
Fields per sectionUp to 500
Section height1 to 40 grid rows
Tab and section names1 to 200 characters

How the asset page uses the detail layout​

The asset page renders the saved detail layout exactly: the same tabs in the same order, each section at the position and size it has in the editor. If there is only one tab, no tab bar is shown. A section holding more fields than fit its height scrolls inside itself. Tabs with no sections are not shown.

The open tab is part of the page address (?tab=), so a link can open a specific tab.

How the create form uses the creation layout​

Create asset asks for the creation layout's fields, in order. Each field's type picks its control, its Mandatory flag decides whether it can be left blank, and its Multi value flag allows several values. Fields that cannot be typed into, and fields the tenant no longer has, are left out.

What integrations add​

When some integrations are added to a tenant, they add a tab to an asset type's detail layout:

IntegrationAsset typeTab
Elastic agentEndpointsElastic Agent
LinkShadow DHCPEndpointsLinkShadow DHCP
CrowdStrike identitiesUsersCrowdStrike Identity
LinkShadow usersUsersLinkShadow

The tab is appended to the existing layout. If the layout already has a tab with that name, its sections are replaced by the integration's.

Adding the integration again resets its tab

Changes you made to an integration's tab are overwritten the next time an instance of that integration is added to the tenant. Put your own sections on a tab with a different name.

See also​

  • Assets: the asset page and the Create asset form
  • Fields: the fields you place in a layout
  • Asset types: each type's default layout