# Homepage

GrainBits gives you a few site-wide controls for shaping how your homepage greets visitors. Each setting is independent, so you can mix and match to land on the layout that suits your site best.

You'll find these options in the Ghost Admin under `Settings → Design & branding → Customize`.

<figure><img src="/files/llwXs5rnXlOQahkWxvQL" alt=""><figcaption></figcaption></figure>

### Homepage logo

Toggles whether your publication logo appears at the top of the homepage. Leave it on if you want your brand front and center, or switch it off for a cleaner, more typography-led opening (especially effective when paired with a custom title and subtitle below).

### Homepage information

Controls whether a custom title and subtitle show up on your homepage. When enabled, the two fields below (Custom title and Custom subtitle) come into play. Turning this off hides both at once, without needing to clear the fields themselves.

#### Custom title

Your homepage headline. This is your chance to greet visitors with something more evocative than your site's default name, like a tagline, a mission statement, or a single bold line that captures what you're about. Leave it blank to hide it entirely.

#### Custom subtitle

A supporting line that sits beneath the custom title. Use it to add context, expand on the headline, or share a brief description of what readers can expect. Leave it blank to hide it.

{% hint style="info" %}
Custom titles and subtitles only show on your homepage. They don't replace your site's SEO title or meta description, so you can write something punchy here without worrying about how it reads in search results.
{% endhint %}

### Popular tags

Toggles a popular tags display on your homepage, giving visitors a quick way to explore your most-used topics. Useful for content-heavy sites where readers might want to dive into a specific theme right away. Hide it if you'd rather keep the homepage focused purely on posts.

### Featured posts

GrainBits lets you showcase featured articles prominently on your homepage. If you prefer a more minimal look, you can disable featured posts using the `Featured posts` setting.

<figure><img src="/files/yrc7chgdjRUMLceJkGx6" alt=""><figcaption></figcaption></figure>

### How to feature a post

To feature a post, navigate to **Posts** in the Ghost Admin and right-click on any post you'd like to highlight.

<figure><img src="/files/BFSpYKThExKJ0YKpr9Up" alt=""><figcaption></figcaption></figure>

Alternatively, open the Settings sidebar while editing a post and toggle **Feature this post**.

<figure><img src="/files/DmGMz1Lu1OdJ3ShMAme2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The featured posts block will adapt to the number of posts you choose to include and always order them chronologically.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://thefinebits.gitbook.io/grainbits/theme-settings/homepage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
