> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://katalyz.crisp.help/en/article/using-the-buyers-logo-19sptzs/).
- **Access settings** (who can open it and how)
- **Theme** (color palette — workspace default, overridable per room; see [Per-room theme](https://katalyz.crisp.help/en/article/per-room-theme-1hv9i4t/))
- **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:

1. **Invitation email** — sent in the room's language setting (no browser to infer from yet)
2. **Once the buyer opens the room** — their **browser language preferences** take over
3. **If browser preferences can't be read** — the room's language setting is used as fallback
4. **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.

## 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](https://katalyz.crisp.help/en/article/section-templates-micro-templates-aob2kc/)

## 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.

## Related articles
- [Adding and reordering pages](https://katalyz.crisp.help/en/article/adding-and-reordering-pages-and-sections-1jg01wj/)
- [Adding and reordering widgets](https://katalyz.crisp.help/en/article/adding-and-reordering-widgets-1dajz6a/)
- [Hiding pages and sections from buyers](https://katalyz.crisp.help/en/article/controlling-visibility-pages-sections-actions-messages-guidelines-vc7vb1/)