> For the complete documentation index, see [llms.txt](https://docs.themeupstudio.com/crimson/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeupstudio.com/crimson/posts/post-layouts.md).

# Post Layouts

Crimson includes **five post layouts (templates)** that control two key reading aids:

* **TOC (Table of Contents):** a generated list of headings that helps readers navigate long articles.
* **Sidebar:** an additional column area for sticky sidebar subscribe form.

You can set a **site-wide default post layout**, and you can also **override the layout per post** from the Ghost editor.

### How post layout selection works

#### A) Site-wide default (recommended)

Set your default once, so every new post uses the same layout unless you override it.

Go to: **Settings → Design → Post** *group* **→ Default post template**

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FzrKbSbRKFENoRCJpFsNR%2Fimage.png?alt=media&amp;token=11816e18-b7fa-40d1-b30f-ae4c21e3d4c5" alt=""><figcaption><p>Default post template setting</p></figcaption></figure>

Options:

* **With Normal TOC and Sidebar**
* **With Sticky TOC and No Sidebar**
* **With Normal TOC and No Sidebar**
* **With Sticky Sidebar and No TOC**
* **With No TOC and No Sidebar**

**How it applies**

* This default applies to **all posts** unless a post explicitly selects a different template.

✅ Best practice

Pick the layout you use most often as your default, then override only special cases:

* very long guides → sticky TOC
* short announcements → no TOC / no sidebar
* conversion-focused posts → sticky sidebar

***

#### B) Per-post override (post editor)

If you want a specific post to use a different layout:

1. Open the post in Ghost Admin (editor)
2. Open **Post settings** (⚙️ in the right sidebar)
3. Find **Post Template**
4. Select the desired template/layout

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FLV7ewwjz6SFAB0gIuvgZ%2Fimage.png?alt=media&amp;token=d3990cac-5344-4c27-bddc-0831eb633647" alt=""><figcaption><p>Override Post Template for a single post</p></figcaption></figure>

**Override rules**

* If a post template is selected → it **overrides** the global `default_post_template`
* If no post template is selected → the post **inherits** the global default

✅ Best practice

Use overrides only when needed, so your site stays consistent.

***

### What “Normal” vs “Sticky” means

#### Normal TOC

* TOC is shown in a regular (non-sticky) position
* It scrolls away with the page like normal content

#### Sticky TOC

* TOC stays visible while scrolling (pinned behavior)
* Best for long-form articles with many headings

#### Normal Sidebar

* Sidebar appears as a standard column
* It scrolls with the page

#### Sticky Sidebar

* Sidebar stays visible while scrolling (pinned behavior)
* Best when you want key navigation/CTA elements accessible continuously

***

### The five layouts (what each one is for)

#### 1) With Normal TOC and Sidebar

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FUqZluFUArO4dYQhjLf3K%2Fimage.png?alt=media&amp;token=9e8137d9-497a-4de6-a073-464f8d47ccee" alt=""><figcaption><p>Normal TOC and Sidebar</p></figcaption></figure>

**Includes**

* TOC: ✅ Yes (normal)
* Sidebar: ✅ Yes (sticky)

**Best for**

* Standard articles where you want both navigation and extra context
* Medium-to-long posts with multiple headings

**Reader experience**

* TOC supports scanning
* Sidebar adds structure without “always visible” sticky behavior

***

#### 2) With Sticky TOC and No Sidebar

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2Fm4MAhcWWTNe3nJ946LWG%2Fimage.png?alt=media&amp;token=abdba95b-c2ec-4d95-a80a-217034872fe3" alt=""><figcaption><p>With Sticky TOC and NO Sidebar</p></figcaption></figure>

**Includes**

* TOC: ✅ Yes (sticky)
* Sidebar: ❌ No

**Best for**

* Long guides, documentation-style posts, tutorials, pillar pages
* Posts with many sections (H2/H3)

**Reader experience**

* Maximum focus on content
* Persistent navigation stays available without extra sidebar clutter

***

#### 3) With Normal TOC and No Sidebar

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FiJ4ffUOkMrkhYn6fqHLu%2Fimage.png?alt=media&amp;token=113fdc2c-224a-457d-a435-e86b86d42197" alt=""><figcaption><p>Normal TOC and NO Sidebar</p></figcaption></figure>

**Includes**

* TOC: ✅ Yes (normal)
* Sidebar: ❌ No

**Best for**

* Posts that benefit from a TOC but need a cleaner, minimal layout
* Editorials, interviews, thought pieces with a few structured sections

**Reader experience**

* TOC is available, but doesn’t stay pinned
* More horizontal space for content (especially noticeable on desktop)

***

#### 4) With Sticky Sidebar and No TOC

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2Fb4tXmmDSdNJByncnwbyT%2Fimage.png?alt=media&amp;token=3f1af2a3-a58d-4713-99d9-5fed80130c8a" alt=""><figcaption><p>Sticky Sidebar and NO TOC</p></figcaption></figure>

**Includes**

* TOC: ❌ No
* Sidebar: ✅ Yes (sticky)

**Best for**

* Posts where TOC isn’t necessary (short/medium posts)
* But you still want persistent secondary elements, such as:
  * newsletter prompts
  * related links
  * sponsorship/CTA content
  * author/metadata emphasis (theme-dependent)

**Reader experience**

* Reading stays uninterrupted (no TOC)
* Sidebar remains accessible throughout scrolling

***

#### 5) With No TOC and No Sidebar

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FZyuddpgxIAPWYWEamNgm%2Fimage.png?alt=media&amp;token=aaf96bca-f055-417f-9216-4fc07aa199b5" alt=""><figcaption><p>No TOC and No Sidebar</p></figcaption></figure>

**Includes**

* TOC: ❌ No
* Sidebar: ❌ No

**Best for**

* Short announcements, quick updates, photo-first posts, personal notes
* Landing-page-like posts where distractions should be minimized

**Reader experience**

* Cleanest, most focused layout
* Ideal when headings are few or when you don’t want extra UI around the post

***

### TOC generation rules (what counts as a TOC item)

When TOC is enabled, it is generated from headings in the post body:

* Typically includes: **H2, H3** headings
* If your post has **no headings**, the TOC may:
  * appear empty, or
  * be hidden (theme-dependent behavior)

✅ Best practice for reliable TOC

* Use **H2** for main sections
* Use **H3** for subsections
* Avoid using headings only for styling—use them to represent real structure

***

### What stays the same across all templates

No matter which layout you choose, posts still include the core post modules (as configured in your site/theme), such as:

* Main post content
* Comments section *(if enabled in Ghost settings)*
* “Read more” / related posts section *(theme feature)*
* A subscribe block at the end *(only when Ghost Members is enabled)*

So the template choice primarily changes:\
✅ TOC behavior\
✅ Sidebar behavior\
—not whether the post has core content blocks.

***

### Troubleshooting

<details>

<summary>My TOC doesn’t show anything</summary>

Most common cause: the post has **no headings**.

Fix:

* Add H2/H3 headings, or
* Switch to a **No TOC** template if your post doesn’t need structure.

</details>

<details>

<summary>Sticky feels odd on mobile</summary>

Sticky elements adapt on small screens. If it feels cluttered, use:

* **With Normal TOC and No Sidebar**, or
* **With No TOC and No Sidebar**

</details>

<details>

<summary>I changed the default but one post didn’t update</summary>

That post likely has a **template override** set.

Fix:

1. Open the post
2. Post settings (⚙️ right sidebar)
3. Clear or reset the **Post Template** selection to **Default**
4. Update the post

Then it will inherit `default_post_template`.

</details>
