# Homepage Layout

**Paragraph** supports customizing **Homepage Layout** in your publication. There are **12 settings**, **3** for each section:

1. <mark style="background-color:orange;">**First section tag**</mark>
2. <mark style="background-color:green;">**First section layout type**</mark>
3. <mark style="background-color:purple;">**First section posts count**</mark>
4. <mark style="background-color:orange;">**Second section tag**</mark>
5. <mark style="background-color:green;">**Second section layout type**</mark>
6. <mark style="background-color:purple;">**Second section posts count**</mark>
7. <mark style="background-color:orange;">**Third section tag**</mark>
8. <mark style="background-color:green;">**Third section layout type**</mark>
9. <mark style="background-color:purple;">**Third section posts count**</mark>
10. <mark style="background-color:orange;">**Fourth section tag**</mark>
11. <mark style="background-color:green;">**Fourth section layout type**</mark>
12. <mark style="background-color:purple;">**Fourth section posts count**</mark>

## <mark style="background-color:orange;">First/Second/Third/Fourth section tag</mark>

This setting is responsible for which **tag's** posts will be displayed in the section. It also has 2 additional options -  '**show-latest-posts**' and '**show-featured-posts**'.

#### show-latest-posts

If you enter '**show-latest-posts**' in this setting, the section will display **6** posts, in order of publication date. Also there will be **Load More** button under this section.&#x20;

{% hint style="danger" %}
Be sure that you have **only one 'show-latest-posts' section** on your home page!
{% endhint %}

#### **show-featured-posts**

If you enter '**show-featured-posts**' in this setting, the section will display only **featured** posts without filtering them by tag. You can choose how many posts to show with [**First/Second/Third/Fourth section posts count**](#first-second-third-fourth-section-posts-count) setting.

### **To customize:**

* Go to **Settings > Design & branding** from the admin menu
* Click **Homepage** in the **Design** settings sidebar on the right
* Find **First section tag/Second section tag/Third section tag/Fourth section tag** menu items
* Enter the **tag slug** whose posts will be displayed in the first/second/third/fourth section. Otherwise, enter '**show-featured-posts**' or '**show-latest-posts**'.

{% hint style="info" %}
If you want to remove the section, just delete all text from this section's **First/Second/Third/Fourth section tag** setting
{% endhint %}

## <mark style="background-color:green;">First/</mark><mark style="background-color:green;">**Second/Third/Fourth**</mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">section layout type</mark>

This setting is responsible for the appearance of posts in the section. It has **16 options:**

1. **Big post with date**
2. **Big post with letter**
3. **Big post with date with image**
4. **Big post with letter with image**
5. **Grid small post with date with image**
6. **Grid small post with letter with image**
7. **Grid small post with date without image**
8. **Grid small post with letter without image**
9. **Grid medium post with date**
10. **Grid medium post with letter**
11. **Grid medium post with date with image**
12. **Grid medium post with letter with image**
13. **List post with date**
14. **List post with letter**
15. **List post with date with image**
16. **List post with letter with image**

### **To customize:**

* Go to **Settings > Design & branding** from the admin menu
* Click **Homepage** in the **Design** settings sidebar on the right
* Find **First section layout type/Second section layout type/Third section layout type/Fourth section layout type** menu items
* **Choose** your preferred layout type for each section

## <mark style="background-color:purple;">**First/Second/Third/Fourth section posts count**</mark>

This setting is responsible for the **number of posts** displayed in the section.&#x20;

{% hint style="warning" %}
This setting does not work if the section's [**First/Second/Third/Fourth section tag**](#first-second-third-fourth-section-layout-type) **setting** is set to '**show-all-posts**', because of how **Ghost CMS** pagination works.
{% endhint %}

### **To customize:**

* Go to **Settings > Design & branding** from the admin menu
* Click **Homepage** in the **Design** settings sidebar on the right
* Find **First section tag/Second section tag/Third section tag/Fourth section posts count** menu items
* **Enter** your preferred number of posts for each section


---

# 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://highfivethemes.gitbook.io/paragraph-user-documentation/custom-settings/homepage-layout.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.