# Article table of contents

Add a table of contents to your blog articles to improve navigation and readability.

***

### Create metafield definition <a href="#h_08597968ff" id="h_08597968ff"></a>

1. Navigate to **Settings** > **Custom Data** > **Blog Posts**
2. Click **Add Definition**
3. In the Name field, type `Table of contents`
4. Ensure the Namespace and Key field is set to `custom.table_of_contents`
5. Click **Select Type** and choose **Single line text**
6. Select **List of values**
7. Click **Save**

[![](https://downloads.intercomcdn.com/i/o/fnubgeik/1429471306/db802e82abb5a1b0d2d61182b79f/CleanShot-2B2024-10-01-2Bat-2B13_32_14-402x.png?expires=1744916400\&signature=d3d2a0b319611221d1d5e185ac7a66a76dd2acc554612ec8df15dbd0945b2c19\&req=dSQlH815nIJfX%2FMW1HO4zcKb7vz8fhheqjb1wPA1KIVjSz3V%2FxVGdb3C71DB%0Aa313juFHcQY9ZJOAn6k%3D%0A)](https://downloads.intercomcdn.com/i/o/fnubgeik/1429471306/db802e82abb5a1b0d2d61182b79f/CleanShot-2B2024-10-01-2Bat-2B13_32_14-402x.png?expires=1744916400\&signature=d3d2a0b319611221d1d5e185ac7a66a76dd2acc554612ec8df15dbd0945b2c19\&req=dSQlH815nIJfX%2FMW1HO4zcKb7vz8fhheqjb1wPA1KIVjSz3V%2FxVGdb3C71DB%0Aa313juFHcQY9ZJOAn6k%3D%0A)

### Update metafield values <a href="#h_1246d7a49d" id="h_1246d7a49d"></a>

1. Navigate to the blog post you'd like to update
2. Scroll to the bottom and click **Show all** next to metafields
3. Enter values for each heading you want to appear in your table of contents

[![](https://downloads.intercomcdn.com/i/o/fnubgeik/1429471129/6e159e64a7a10f89a05255fc633d/CleanShot-2B2024-10-01-2Bat-2B13_35_31-402x.png?expires=1744916400\&signature=c3628e36ae43be52763ea1ee4723edfd47c991fa4dc73019002c75a466928791\&req=dSQlH815nIBdUPMW1HO4zZk5CDBi0o9xPKilSo8xTZJYGfVcFkKZEs7ufi3K%0AxlSjkwRcauHwzSjKBoo%3D%0A)](https://downloads.intercomcdn.com/i/o/fnubgeik/1429471129/6e159e64a7a10f89a05255fc633d/CleanShot-2B2024-10-01-2Bat-2B13_35_31-402x.png?expires=1744916400\&signature=c3628e36ae43be52763ea1ee4723edfd47c991fa4dc73019002c75a466928791\&req=dSQlH815nIBdUPMW1HO4zZk5CDBi0o9xPKilSo8xTZJYGfVcFkKZEs7ufi3K%0AxlSjkwRcauHwzSjKBoo%3D%0A)

### Add block <a href="#h_565e4fb7a1" id="h_565e4fb7a1"></a>

1. In the Shopify Theme Editor, navigate to the Blog Post Template
2. Click **Add Block** under Article Main
3. Search and select **Table of Contents**

***

### Update headings <a href="#h_f46e698855" id="h_f46e698855"></a>

1. In Shopify, navigate to the blog post you'd like to update
2. Click the **Show HTML** icon on your blog content
3. Add `id="HEADING-NAME"` to your heading tags. The `id` attribute should match the table of contents
   * Example: `<h1 id="your-heading-text">Your Heading Text</h1>`.
4. Hit **Save**

[![](https://downloads.intercomcdn.com/i/o/1200396515/e07b0686cf8333df4de12f10/CleanShot+2024-10-01+at+13_48_22%402x.png?expires=1744916400\&signature=d710b68c58bcccbded8cbafc65c3c890b0742062b4ed447a670fdbd29c083fd6\&req=dSInFsp3m4ReXPMW1HO4zfEMOZL3q3uWwB8wmqAlo1s6IJgY0WbDdvNTIRil%0ATynoxhvL8Qs%2FDWRmTE4%3D%0A)](https://downloads.intercomcdn.com/i/o/1200396515/e07b0686cf8333df4de12f10/CleanShot+2024-10-01+at+13_48_22%402x.png?expires=1744916400\&signature=d710b68c58bcccbded8cbafc65c3c890b0742062b4ed447a670fdbd29c083fd6\&req=dSInFsp3m4ReXPMW1HO4zfEMOZL3q3uWwB8wmqAlo1s6IJgY0WbDdvNTIRil%0ATynoxhvL8Qs%2FDWRmTE4%3D%0A)\\
