Knowledge Baseintermediate

Section and role blocks reference

Settings and usage guidance for the five section and role blocks — Section grid, Section list, Section bar, Role grid, and Role bar.

3 min read

Section and role blocks reference

Five blocks render curated sections and role-filtered navigation on the public help center: Section grid, Section list, and Section bar for sections; Role grid and Role bar for browsing roles. Their block-specific settings and when to use each are below. For the full 20-block catalogue, see the Portal blocks reference.

Section blocks

Section grid

A grid of your sections. Each tile is a section, and clicking it opens that section’s page rather than an individual article.

Settings:

  • Sections: a multi-select. Leave it empty to show all sections, up to the Max sections limit (9 by default); otherwise the grid shows the sections you picked, in the order you selected them.
  • Helper link text and address: an optional link shown alongside the grid, with the text you enter pointing to the address you set.
  • Badge text: an optional badge on the tiles, with Show the badge on controlling which tiles display it.
  • Highlight: emphasizes the tiles you choose to stand out from the rest.
  • Columns: 2, 3, 4, or 6. The 6-column layout appears as 6 columns on desktop, 3 on tablet, and 2 on phone.
  • Icon style: includes a Grey tile option for the tile icons.

The badge text and helper link text are translated along with the page.

When to use: to feature curated topics on the homepage. “Most popular”, “For developers”, “Returns and refunds”.

Section list

A vertical list version of Section Grid.

Settings: max items.

When to use: in dense layouts where a grid would dominate the page.

Section bar

A horizontal bar of sections — each section gets a tab-like entry, and clicking it loads that section’s articles inline.

Settings: list of sections to include, default open section, layout style.

When to use: to let customers switch between curated topics without leaving the page.

Role blocks

Role grid

A grid of browsing roles — each tile takes the customer to a role-filtered view. “I’m a developer”, “I’m an end user”.

Settings: roles to include, tile style, description per role.

When to use: when your help center serves multiple audiences with very different needs. Multi-product or multi-audience SaaS help centers.

Role bar

A horizontal bar version of Role Grid.

Settings: roles to include, default selected role.

When to use: when role-filtering is a primary navigation, not a secondary one.

See also

Tags

Reference