> 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/homepage/top-categories.md).

# Top Categories

**Top Categories** is an automatic discovery block on the Crimson homepage that highlights your most-used categories (tags). It helps readers quickly jump into the topics your site publishes the most.

Crimson builds this section automatically by finding the **top 4 tags** with the **highest number of published posts** assigned to them.

<figure><img src="/files/IFbYNLNrQGbKToO2EWTC" alt=""><figcaption><p>Top Categories Section on Homepage</p></figcaption></figure>

### Where it appears

This section is **auto-injected** into the homepage flow:

* It appears **after the 2nd Tag Section**

There is no separate “position” setting for it—its placement is based on the tag-section index.

{% hint style="warning" %}
If you have fewer than **2** Home Tag Sections configured, you may not see Top Categories at all (because the injection point is never reached).
{% endhint %}

***

### What it shows

#### Top 4 tags (by post count)

Top Categories displays:

* at max **4 tags**
* selected based on **which tags have the most published posts** assigned to them

***

### Troubleshooting

<details>

<summary>Top Categories is not showing</summary>

Check:

1. Do you have at least **2 Home Tag Sections** enabled via `Tag slugs to show on home`?
   * Top Categories is injected **after the 2nd section**, so it won’t appear if you only have 0 or 1 tag section.
2. Do you have enough published posts and tags in general?

</details>

<details>

<summary>The tags shown are not the ones I want</summary>

This section is **automatic** and based on **post count**, not manual selection.

To influence what appears:

* Use your desired “category” tags more consistently
* Merge or delete unused tags
* Avoid creating too many similar tags that split your content (e.g., `tech-news` vs `news`)

</details>