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

# Homepage

Build a homepage around your articles, videos, promotions, and signup forms.

Open the [website editor](https://help.convella.com/website/design#open-the-website-editor), then select **Home**.

## Choose a layout

Under **Home → Layout**, choose how to organize your homepage:

* **Single feed** — Display your articles in one feed.
* **Custom layout** — Build your homepage from sections you can add, customize, and rearrange.

With **Single feed**, select **Feed** to choose a **List**, **Grid**, or **Classic** layout. You can also enable **Group articles by tag**.

## Hero

The hero is the introductory section at the top of your homepage. Select **Hero** under **Home** to customize it:

* **Content** — Edit the title and subtitle, show an email signup form, and add an image beside your text. When an image is present, you can adjust its position and size.
* **Background** — Add a background image or video. Upload a file, or choose **Clip from YouTube video** for a video background. Adjust the background mask to keep your text readable.
* **Colors** — Choose the hero's section color theme.

Turn off **Show hero** to hide this section.

## Custom sections

With **Custom layout** selected, click **Add section** under **Home**. Choose from four section types.

![Add section dialog offering Articles, Promo, About, and Subscribe](https://mintcdn.com/convella/pBat-kSuSzw_lXD9/images/website/add-section.jpg?fit=max\&auto=format\&n=pBat-kSuSzw_lXD9\&q=85\&s=c7664e9634d89f559d41e31a3ac121d3)

### Articles

Choose a **Source** for the articles in this section:

* **Latest** — Your most recent articles.
* **Popular** — Articles ranked by their source videos' YouTube view counts.
* **Handpicked** — Select and arrange specific articles yourself.
* **Tags** — Choose a tag to show articles associated with it.

Under **Design**, choose **List**, **Grid**, **Single article**, **Highlight**, or **Magazine**. The available controls vary by layout, including how many articles to show and how they're arranged.

### Promo

Highlight a product, service, or offer. Add a title, description, image, and a button linking to your chosen destination.

### About

Introduce yourself or your website with a description, image, and optional button.

### Subscribe

Invite visitors to join your audience. Customize the text, image, and subscribe button. Enable **Show email field** to let visitors enter their email directly in the section.

> [!NOTE]
>
> Email signup forms require newsletters to be enabled. You can manage them in [Newsletter settings](https://convella.com/site?publicationSettings=newsletters).

## Customize and arrange sections

Select a section in the editor's sidebar to open its controls:

* **Content** — Edit text, images, links, or the article source.
* **Design** — Adjust layouts, alignment, image sizes, and other display options available for that section.
* **Colors** — Use your site's default section theme or choose a different one.

To rearrange a section, open its **•••** menu and choose **Move up** or **Move down**. Choose **Remove** to delete the section from your homepage.

## Article previews

Under **Home → Article previews**, choose which details appear in your homepage's article previews:

* **Show images**
* **Show tag**
* **Show description**
* **Show author**
* **Show date**
* **Show read time**

![Home settings with the custom layout and article preview visibility options](https://mintcdn.com/convella/pBat-kSuSzw_lXD9/images/website/homepage-layout.jpg?fit=max\&auto=format\&n=pBat-kSuSzw_lXD9\&q=85\&s=bfe785e7a968055174f44a3a46e1dd18)

## Preview and save

Switch between **desktop** and **mobile** previews to check your homepage on different screen sizes. Click **Save** to apply your changes.


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