Articles on: Rooms

How rooms are organized

Every Katalyz room follows the same four-layer structure: room → pages → sections → widgets.

Room

The top-level container. It has:

A title (visible to buyers)
Logos (two of them):
- Seller logo — pulled from your workspace's Brand assets (set once by an admin; can't be overridden per room)
- Prospect logo — set per room from the Design tab → Header → Prospect logo (search a brand via Brandfetch or upload manually). See Prospect logo.
Access settings (who can open it and how)
Theme (color palette — workspace default, overridable per room; see Per-room theme)
Language (rules the room's default — see below)
Participants (people with access)
Activity feed (history of visits, edits, comments)

How room language actually works

The room-level language setting is only the default — actual buyer-facing language is resolved per-user in this order:

Invitation email — sent in the room's language setting (no browser to infer from yet)
Once the buyer opens the room — their browser language preferences take over
If browser preferences can't be read — the room's language setting is used as fallback
Per-user override — you can force a specific language for a specific participant from the Participants page (their user profile)

So the room-level language mostly drives invitation emails; once the buyer is in, it's their browser that rules.

The header — layout options

The room header is where buyers see your logos, the room title and the page tabs. Its layout is set per room from the Design tab → Header group in the left panel:

Header layout

Option	What it does
Single bar	Page tabs sit inline in the header row — logos, tabs and actions on one line. The page tabs take the title's place.
Two bars	Page tabs sit on their own bar below the header — a primary bar for logos and title, a secondary bar for navigation.

Two checkboxes depend on that choice:

Overlay mode — Start transparent, show background on scroll: the header floats over the page cover and gains its background as the buyer scrolls. Only available with Single bar (with two bars it's greyed out: "Not available while the secondary bar is shown").
Show title — Show the room name in the header. Only offered with Two bars, since in single-bar mode the tabs occupy that space.
Show shadow — Add a subtle shadow below the header.
Show sections — Display as dropdowns: each page tab opens a dropdown of its sections.

Styling the bars

Primary bar — Primary bar color, Primary bar text color, Primary bar opacity. With Overlay mode on, the color fields apply (on scroll), and an extra Overlay Text Color (before scroll) field controls the text while the header is still transparent.
Secondary bar (Two bars only) — Secondary bar color, Secondary bar text color, Secondary bar opacity.

Design tab → Header group with "Header layout" set to Two bars and the Secondary bar styling fields

Pick Single bar + Overlay mode for hero-style rooms with a strong cover image; pick Two bars when a room has many pages or you want the room name always visible.

Pages

Top-level containers within the room. Pages are the centerpiece of navigation — they appear in the room's header (where buyers click to move between them) and also in the nav tree in the left sidebar.

Each page:

Has its own title (shown in the header, the sidebar, and at the top of the page)
Can be visible or hidden from buyers
Has its own URL anchor (so you can deep-link to a specific page)

Think of pages as chapters in the room's story. Simple rooms may have a single page; larger rooms often have 3–6.

Sections

Parts of a page that group related widgets together. A section is a visual container inside a page. A page can have multiple sections.

Each section:

Has its own title (optional)
Can be visible or hidden from buyers independently from the parent page
Can be saved as a micro-template (section template) and dropped into any other room from the left sidebar — see Section templates

Widgets (widgets)

The actual content inside a section. Each block is a widget — text, image, video, CTA, pricing, signature, meeting scheduler, etc.

Think of widgets as paragraphs within a chapter.

The full hierarchy

Room (Acme × Katalyz proposal)
├── Page: Overview
│   └── Section
│       ├── Text block — welcome
│       ├── Video block — personalized intro
│       └── CTA widget — "Watch the demo"
├── Page: Solution
│   ├── Section: Problem
│   │   └── Text block
│   └── Section: Our approach
│       ├── Image block — architecture diagram
│       └── Steps block — implementation timeline
├── Page: Pricing
│   └── Section
│       ├── Text block — pricing narrative
│       ├── Document block — pricing PDF
│       └── CTA widget — "Talk to our team"
└── Page: Contract
    └── Section
        ├── Text block — legal intro
        └── Signature block — MSA

Choosing the right structure

Most effective rooms have:

3–6 pages (enough to structure; not so many buyers get lost navigating)
1–3 sections per page (group related content, don't force artificial splits)
3–7 widgets per section (enough to tell the story; not so many it feels padded)

Too few pages → the room feels like one long scrolling document.
Too many → the buyer gets lost in navigation.

Updated on: 02/10/2026

Was this article helpful?

Thank you!