# AI summary (TL;DR)

{% hint style="info" %}
**Who can use this feature?**

* This feature is available for Pro and Advanced users
  {% endhint %}

AI Summary automatically generates a short TL;DR summary for your blog posts. The summary is displayed at the top or bottom of each post on your storefront, helping readers quickly understand the main points before reading the full article.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F9YByS1srWYFIy6ikFiYR%2Fimage.png?alt=media&#x26;token=f8f97bc6-6435-46a7-a7e9-6c8052444006" alt=""><figcaption></figcaption></figure>

**Location in app:** Sections > AI Summary

### Settings <a href="#settings" id="settings"></a>

Configure AI Summary on the **Settings** tab:

| Setting             | Options                              | Description                                                               |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
| **Summary length**  | Short, Medium, Long                  | Controls how detailed the generated summary is                            |
| **Format**          | Paragraph, Bullets, Numbered, Hybrid | Controls the visual format of the summary                                 |
| **Store languages** | Select languages                     | Choose which languages to generate summaries in (for multilingual stores) |
| **Voting buttons**  | On / Off                             | Show "Helpful" and "Not helpful" buttons for reader feedback              |

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FD4g1XMewbMibu5f2lRxq%2Fimage.png?alt=media&#x26;token=2480c855-b7d1-44c3-9dc0-9bf41a6c4323" alt=""><figcaption></figcaption></figure>

### Summary Manager <a href="#summary-manager" id="summary-manager"></a>

Switch to the **Summary Manager** tab to manage summaries for individual posts:

* **Generate for a single post** - Click the menu on any post and select **Generate**.
* **Bulk Generate** - Create summaries for all posts at once.
* **Regenerate** - Update a summary if the post content has changed.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F1bO2ldnasv8euhraT36o%2F34.jpg?alt=media&#x26;token=b1d5bc3e-fcb1-462c-8e1d-6c6c081779e9" alt=""><figcaption></figcaption></figure>

### Theme block installation <a href="#theme-block-installation" id="theme-block-installation"></a>

To display AI Summary on your storefront, add the AI Summary block to your Shopify theme:

1. In the app, go to **Sections > AI Summary**.
2. If the block has not been added, a warning banner appears with an **"Add block"** button.
3. Click the button to open the Shopify Theme Editor directly at the correct location.
4. Confirm the block is added to your article template.
5. Save your theme changes.
6. Return to the app and click **Refresh** to confirm detection.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FqDVJMXyx93Ay3dJWk5ga%2F35.jpg?alt=media&#x26;token=4b681237-4e6b-41fe-a944-85cba448c0f8" alt=""><figcaption></figcaption></figure>

### AI credit usage <a href="#ai-credit-usage" id="ai-credit-usage"></a>

| Action                   | Credits                       |
| ------------------------ | ----------------------------- |
| First summary for a post | Free (0 credits)              |
| Regenerating a summary   | 1 credit per enabled language |

### Notes <a href="#notes" id="notes"></a>

* AI Summary requires the **Pro plan** or above. Free and Basic plan users will see an upgrade prompt.
* Summaries are generated per post. Each post can have its own summary.
* The summary updates when you regenerate it, not automatically when post content changes.
* Multilingual summaries are generated separately for each enabled language.
