> ## Documentation Index
> Fetch the complete documentation index at: https://learn.catalogbuilderapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Layout Tab (Grouping & Structure)

> Learn how to structure catalog pages using By Priority and By Category grouping modes, reorder sections with drag-and-drop, and rename categories.

The **Layout Tab** in the Catalog Editor gives you total control over the structural sequence, page grouping, and reading flow of your catalog.

Whether you want to showcase flagship products upfront or organize items into logical category chapters, the Layout Tab automatically distributes your products and calculates pagination in real time.

***

## Grouping Modes

At the top of the Layout Tab, use the segmented control to switch between the two core structural strategies:

### 1. By Priority Mode

In **By Priority** mode, pages are sequenced strictly according to the layout importance assigned to each product.

<Frame caption="By Priority Mode in the Layout Tab — Light & Dark Modes">
  <img className="block dark:hidden rounded-lg max-w-sm mx-auto" src="https://mintcdn.com/catalog-builder-app/W78ML57neWm6jD0N/images/editor/layout-tab-priority-light.png?fit=max&auto=format&n=W78ML57neWm6jD0N&q=85&s=1130762aa6034de47d5ac8f1cb8af24c" alt="Layout Tab By Priority Light Mode" width="413" height="636" data-path="images/editor/layout-tab-priority-light.png" />

  <img className="hidden dark:block rounded-lg max-w-sm mx-auto" src="https://mintcdn.com/catalog-builder-app/W78ML57neWm6jD0N/images/editor/layout-tab-priority-dark.png?fit=max&auto=format&n=W78ML57neWm6jD0N&q=85&s=d194b0a909e7ec753d4088eb5701c20d" alt="Layout Tab By Priority Dark Mode" width="415" height="690" data-path="images/editor/layout-tab-priority-dark.png" />
</Frame>

#### How By Priority Works:

* **Sequential Hierarchy**: Pages flow from the most prominent featured items down to compact multi-product grids:
  1. **Portada (Cover)**: Special front cover page.
  2. **Índice (Table of Contents)**: Automated chapter index.
  3. **1 product page (Featured / 1st Priority)**: Full-page high-impact displays.
  4. **2 products page (Premium / 2nd Priority)**: Half-page balanced layouts.
  5. **Cuadrícula de productos (Grid / 3rd Priority)**: Multi-product grid spreads.
  6. **Información de Empresa (Organization Page)**: Special back cover contact page.
* **Best Used For**: Promotional campaigns, seasonal lookbooks, and sales brochures where top-tier products must capture customer attention before standard catalog items.

***

### 2. By Category Mode

In **By Category** mode, products are grouped into distinct thematic chapters based on their assigned product category.

<Frame caption="By Category Mode in the Layout Tab — Light & Dark Modes">
  <img className="block dark:hidden rounded-lg max-w-sm mx-auto" src="https://mintcdn.com/catalog-builder-app/W78ML57neWm6jD0N/images/editor/layout-tab-category-light.png?fit=max&auto=format&n=W78ML57neWm6jD0N&q=85&s=2ee53944eadd514c0c9ed18c1695ed72" alt="Layout Tab By Category Light Mode" width="343" height="1024" data-path="images/editor/layout-tab-category-light.png" />

  <img className="hidden dark:block rounded-lg max-w-sm mx-auto" src="https://mintcdn.com/catalog-builder-app/W78ML57neWm6jD0N/images/editor/layout-tab-category-dark.png?fit=max&auto=format&n=W78ML57neWm6jD0N&q=85&s=0e4dda99192d08a30e47e4fe9b568ddf" alt="Layout Tab By Category Dark Mode" width="343" height="1024" data-path="images/editor/layout-tab-category-dark.png" />
</Frame>

#### How By Category Works:

* **Thematic Chapters**: Categories (e.g., *Furniture*, *Electrónica*, *Electronics*, *Home Appliances*) act as independent sections.
* **Category Counter Badges**: Displays the total count of products contained within each category (e.g., `3 products`, `5 products`).
* **Sub-tier Accordion Structure**: Expanding a category reveals its internal layout tiers:
  * **Featured Products (1 prod / page)**
  * **Premium Products (2 prods / page)**
  * **Grid Products (Grid)**
* **Sub-tier Product Counters**: Real-time badges indicate how many products in that category belong to each priority tier (e.g., `3 prods`, `4 prods`, or `0 prods`).
* **Best Used For**: Comprehensive wholesale catalogs, retail department guides, and multi-brand catalogs where readers shop by department.

***

## Interactive Customization Features

<CardGroup cols={2}>
  <Card title="Drag-and-Drop Reordering" icon="arrows-up-down">
    Use the grip handles (**⠿**) to reorder entire categories or rearrange the sequence of special pages. You can also reorder sub-tiers within each category to dictate whether featured items or grid spreads appear first.
  </Card>

  <Card title="Click-to-Rename Sections" icon="pencil">
    Click on any section title or category name to edit it inline. Press **Enter** or click the checkmark to save. Custom section names automatically update on catalog page headers and the Table of Contents.
  </Card>

  <Card title="Automated Page Math" icon="calculator">
    Whenever you change grouping modes or reorder sections, CatalogBuilderApp recalculates spreads, pagination, and page splits dynamically without manual redesigning.
  </Card>

  <Card title="Special Page Locking" icon="sparkles">
    Special pages (such as the Table of Contents or Organization Back Cover) display clear **Plus** badges if your plan requires an upgrade, with instant one-click unlocking modals.
  </Card>
</CardGroup>

<Tip>
  **Instant Canvas Preview**: You do not need to save to preview changes. Every drag-and-drop or rename action updates the interactive canvas immediately so you can verify page balance in real time!
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.