How to Embed a Section Inside Your Article Content

You can insert a custom section directly into your article content using a special shortcode. This is perfect for adding dynamic or reusable content blocks—like forms, banners, or product highlights—anywhere in your article. For the most flexibility, we recommend creating a unique blog post template for each article where you want to use this feature.

---

Step 1: Create a New Blog Post Template and Assign It

1. In your Shopify admin, go to Online Store > Themes and click Customize on your current theme.

2. In the theme editor, use the page selector at the top to navigate to a blog post.

3. Click the dropdown at the top center and select Create template. Give your new template a unique name (e.g., custom-article-template).

4. 
5. Customize this template as needed. This will allow you to add unique sections or content for this specific blog post. For this tutorial to work, you MUST use the Design Pack section called Article content (all of the Design Pack blog post templates use this section, eg. Browse and Spotlight)

   
6. Save the template.

7. Assign this new template to your desired blog post:

   • Go to Online Store > Blog Posts in your Shopify admin.

   • Edit the blog post you want to update.

   • In the Theme template section, select your new template and save.

---

Step 2: Set Up the Section with a Link anchor ID

• Add a new section in your theme editor and configure (while editing your new blog post template).

• Go to the Advanced settings for the section.

• In the Link anchor id field, enter a value that starts with embed (for example: embed-newsletter, embed-promo, or embed-gallery).

• Important: The anchor id must begin with embed for this feature to work.

• Why? Sections with an anchor id starting with embed are hidden from the main page and only appear where you place the shortcode.

---

Step 3: Add the Shortcode to Your Article

In your article content, insert the following shortcode exactly where you want the section to appear:

[#embed-section#]

• Replace embed-section with the exact value you set in the Link anchor id field. Eg. [#embed-gallery#]

• There must be no spaces anywhere in the shortcode.

---

Step 4: Save and Preview

1. Save your article.

2. When you view the article, the section will appear exactly where you placed the shortcode. You can edit the section as needed and it will updated in the article. You can add multiple embedded sections into your article with the same approach. Eg. [#embed-gallery-1#], [#embed-gallery-2#], etc

---

Examples

Newsletter Signup

Link anchor id: embed-newsletter

Shortcode:

[#embed-newsletter#]

Promotional Banner

Link anchor id: embed-promo-banner

Shortcode:

[#embed-promo-banner#]

Contact Form

Link anchor id: embed-contact-form

Shortcode:

[#embed-contact-form#]

Custom Gallery

Link anchor id: embed-gallery

Shortcode:

[#embed-gallery#]

---

Notes & Best Practices

• The Link anchor id must start with embed (e.g., embed-form, embed-banner, embed-gallery).

• The shortcode must be in the format:

  [#embed-section#]

  with no spaces.

• If you remove the shortcode from your article, the section will not display anywhere on the page.

• You can use this feature to add forms, banners, or any custom content block to your articles.

• Creating a unique template for each blog post gives you maximum flexibility for custom content. Alternatively, you can create metaobjects to populate the sections and use the same template for multiple articles (knowledge of metafields and metaobjects is required)

• You will see a "HTML error found" warning message on the template with this approach, but this can safely be ignored and only appears in the theme editor (it appears because we are nesting the section in another section)

  

---

Need help?

If you have questions or need assistance, contact our support team at [e-mail].