> For the complete documentation index, see [llms.txt](https://staylime.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-subtitle.md).

# Product subtitle (short description)

Product subtitle lets you display a second line of text below the product title — on product pages, in collection grids, and in search results. A common use: showing material, style type, or a short tagline that doesn't belong in the main product name.

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

***

### Setup

Product subtitle uses a Shopify metafield. Set it up once in Admin, then fill in the subtitle for each product individually.

{% stepper %}
{% step %}

#### **Step 1: Create the metafield definition**

1. Go to **Shopify Admin → Settings → Metafields and metaobjects → Products**
2. Click **Add definition**

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

4. In the **Name** field, type `Product subtitle` — Shopify will suggest the reserved metafield with the same name. Select it from the suggestions.
5. Click **Save**

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

{% hint style="warning" %}
Use the suggested **Product subtitle** definition (namespace: `descriptors`, key: `subtitle`), not a custom one with a different key. The theme reads from this specific field.
{% endhint %}
{% endstep %}

{% step %}

#### **Step 2: Add content to products**

Go to **Shopify Admin → Products**, open any product, scroll down to the **Metafields** section, and fill in the **Product subtitle** field.

<figure><img src="/files/xkY2H0g27zMGJK8Kvx0o" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Step 3: Enable in Theme Editor

**On the product page** — the **Subtitle** block is part of Product overview by default. If it's missing, add it via **Add block → Subtitle**.&#x20;

After adding the block, click it to open its settings. In the right panel, find the **Text** field — it must show **Product subtitle** (displayed as a blue label, meaning it's connected to the metafield). If the field is empty or shows plain text, click the connect icon next to it and select **Product subtitle**.

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

**On collection and search cards** — go to the **Collection page** or **Search results** section settings and enable **Show short description**.

<figure><img src="/files/EeE3djCYGrwiaRSehWHu" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Troubleshooting: subtitle not showing on the product page

If you've created the metafield, filled it in, and added the Subtitle block — but the subtitle still doesn't appear — check the block's dynamic source.

In Theme Editor, click the **Subtitle** block to open its settings. Look for the dynamic source indicator (a link icon next to the text field). It must point to **Product subtitle** (`descriptors.subtitle`). If it shows a different field — for example, MODEL\_DESCRIPTION — click the source icon and switch to the correct metafield.

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

{% hint style="info" %}
This mapping issue is the most common reason subtitle doesn't show after setup. The block can be connected to any text metafield, so after adding it make sure it's reading from the right one.
{% endhint %}

***

### What product subtitle is not

Product subtitle outputs **plain text only** — it cannot be used for colored labels or badge-style callouts. If you want to display styled product badges (e.g., "New", "Sale", "Bestseller"), that's a separate feature using the `custom.badge` metafield. See [**Product badges**](/docs/avante-themes/features-and-advanced-setup/product-badges.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://staylime.com/docs/avante-themes/features-and-advanced-setup/product-subtitle.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.