# Advanced elements

Advanced elements unlock the full potential of the SEO On Blog editor. While Basic elements cover everyday content needs, Advanced elements let you embed products, drive conversions with CTAs, and integrate social media - turning your blog into a sales and SEO machine.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FAd5m8JO3UshGVK6mmFzE%2Fadvanced.jpg?alt=media&#x26;token=3cdcd507-66f0-4231-a726-65a5615bc6cf" alt=""><figcaption></figcaption></figure>

### Product elements <a href="#product-elements" id="product-elements"></a>

#### Product <a href="#product" id="product"></a>

Display products from your Shopify store directly in your blog post. Select up to 20 products per block and customize how they appear with content and button settings.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FiiY7I4tdinH9m2wigFlh%2Fproducts.png?alt=media&#x26;token=000ebe84-47ef-404b-926d-63f8e549bb63" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Product element or type `/product`
2. Search and select products from your Shopify store (up to 20)
3. Configure content display and button settings

**Best practices:**

* Show **3-5 products per block** for optimal layout
* Blog product blocks convert **3-5x better** than homepage grids
* Best for: product roundups, gift guides, "Editor's Picks", seasonal collections

***

#### Product Details <a href="#product-details" id="product-details"></a>

Show the full details of a selected product - description, price, images, and variants. A complete product page experience inside your blog post.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FLIcQ426YFMsFa12nXU33%2Fproductdetails.jpg?alt=media&#x26;token=784f03c0-30ad-4b65-b7aa-ff40b988b880" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Product Details element or type `/productdetails`
2. Search and select one product
3. The full product view renders inline

**Best practices:**

* Use for **dedicated product posts** (reviews, launches, deep dives)
* Don't use multiple Product Details in one post - too heavy
* Best for: product reviews, new product announcements

***

#### Product Card <a href="#product-card" id="product-card"></a>

Display a compact product card that shows key information in a popup-style view. Readers see product details without leaving the blog post.

{% embed url="<https://app.arcade.software/share/aeMOwGDzc49Eknq8vi34>" %}

**How to use:**

1. Add a Product Card element or type `/product card`
2. Select a product from your store
3. A compact card renders inline

**Best practices:**

* Keep to **1-3 cards per row** for clean layout
* Best for: brief product mentions, "shop the look" callouts

***

#### Text & Product <a href="#text--product" id="text--product"></a>

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FkrfYkjQvatfzJdKdjrAH%2Ftext%20%26%20product.png?alt=media&#x26;token=44c4c5d0-5941-4aa1-bb27-8f0cc4f62201" alt=""><figcaption></figcaption></figure>

A two-column layout pairing text content on one side with a product display on the other. Magazine-style editorial commerce.

**How to use:**

1. Add a Text & Product element or type `/text & product`
2. Write editorial text on the left
3. Select a product to display on the right

**Best practices:**

* Text left, product right is the standard reading pattern
* Best for: Editor's Pick sections, product spotlights, story-driven selling

***

### Content Organization <a href="#content-organization" id="content-organization"></a>

#### Table of Contents <a href="#table-of-contents" id="table-of-contents"></a>

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FvbiaDRsem9laFbdsDs1j%2Ftoc.jpg?alt=media&#x26;token=05001887-3a30-4b7d-999a-f4bfafa024ca" alt=""><figcaption></figcaption></figure>

Automatically generates a clickable table of contents from the headings (H2, H3, H4, H5) in your post. Updates automatically as you add or change headings.

**How to use:**

1. Add a Table of Contents element or type `/toc`
2. (Optional) Customize the title
3. The TOC auto-populates from your post headings

**Best practices:**

* Place **after the intro paragraph**, not at the very start
* Use for posts with **3+ headings** (1,500+ words)
* Reduces bounce rate by \~30% on long-form content
* Can appear as **sitelinks** in Google search results

> **SEO Tip:** For best results, use consistent heading levels throughout your post. The TOC updates automatically.

***

#### Related Posts <a href="#related-posts" id="related-posts"></a>

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FKsuwtVLXVz0gTj8P4U2m%2Frelatedpost.jpg?alt=media&#x26;token=4ea8a632-22e1-4741-badc-6d1d678a4ce8" alt=""><figcaption></figcaption></figure>

Display posts related to the current article, matched by tag or category. Keeps readers on your blog longer.

**How to use:**

1. Add a Related Posts element or type `/relatedposts`
2. Posts are automatically matched by tag/category
3. Place at the end of your post

**Best practices:**

* Show **3 related posts** for optimal layout
* Reduces bounce rate by keeping readers engaged
* Place near the end of the post

***

#### Recent Posts <a href="#recent-posts" id="recent-posts"></a>

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FtMM1oVXbsME5djHrisDf%2FRecent%20posts.png?alt=media&#x26;token=e5f4834f-0db5-4f36-877c-fc07f03e9245" alt=""><figcaption></figcaption></figure>

Display your most recently published blog posts. Signals fresh content to both readers and Google.

**How to use:**

1. Add a Recent Posts element or type `/recent posts`
2. The element automatically shows your latest published posts

**Note:** Requires at least 3 published posts to appear correctly.

***

### Engagement & CTA <a href="#engagement--cta" id="engagement--cta"></a>

#### Button <a href="#button" id="button"></a>

Add a customizable call-to-action button. Direct readers to product pages, collections, signup forms, or any URL.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F68K3XKuJCNDSlRBl1saK%2Fbutton.jpg?alt=media&#x26;token=6f2ec1be-b6ac-44ac-b7c8-f7d00cff8ed3" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Button element or type `/button`
2. Set the button text, link URL, and style
3. Configure alignment

**Best practices:**

* Use **action verbs**: "Shop Now", "Get Yours", "Learn More"
* One primary CTA per section
* Place **after compelling content** that motivates action

***

#### Checkout Button <a href="#checkout-button" id="checkout-button"></a>

A buy button that lets readers purchase a product or add it to their cart directly from your blog post. Connected to a specific Shopify product.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FHNVvhBolC7BTEKxWc9VD%2Fcheckbutton.jpg?alt=media&#x26;token=68d8c210-eb13-4cb3-8f00-e137224c4351" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Checkout Button element or type `/checkout`
2. Select a Shopify product to connect
3. Choose mode: "Buy Now" (direct checkout) or "Add to Cart" (multi-item)

**Best practices:**

* "Buy Now" for impulse purchases, "Add to Cart" for multi-item shopping
* Pair with a **product image** above for context
* Zero-friction purchase path - reader goes from blog to checkout in one click

***

#### CTA Banner <a href="#cta-banner" id="cta-banner"></a>

Create an eye-catching call-to-action banner combining a headline, description text, and a button.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FFw5JDZ9fw6Dkv5JXYISe%2Fbanner.jpg?alt=media&#x26;token=04b3faa7-d1a2-4fe4-9d74-650f49514e7b" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a CTA Banner element or type `/cta`
2. Write a headline (max 8 words)
3. Add description (1-2 sentences)
4. Configure the button text and link

**Best practices:**

* 50%+ CTR lift vs plain text links
* Place **mid-post and at the end** for maximum exposure
* Best for: newsletter signups, sale promotions, product launches

***

#### Testimonials <a href="#testimonials" id="testimonials"></a>

Display customer reviews or testimonials with avatar, name, title, and star ratings.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FvQYMFCs85rHba9ofKFtB%2Ftestimonial.png?alt=media&#x26;token=7cec8c7a-7260-4979-9706-20631b734e95" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Testimonials element or type `/testimonials`
2. Fill in: review text, reviewer name, title, and profile URL
3. Upload reviewer's image
4. Set star rating

**Best practices:**

* Use **real reviews** from verified customers
* **3 testimonials** is the sweet spot
* Place near product elements or checkout buttons
* Customer testimonials improve conversion by \~34%

***

### Rich Content <a href="#rich-content" id="rich-content"></a>

#### FAQs <a href="#faqs" id="faqs"></a>

Add a frequently asked questions section. Write Q\&As manually or use AI to generate them from your post content. Supports FAQ schema (structured data) for Google rich snippets.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FyaaU7qsydC1BTOaNoN5k%2Ffaqs.jpg?alt=media&#x26;token=c3751de4-810c-49a6-9324-f2d54a8757da" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a FAQs element or type `/faq`
2. Write questions and answers manually, or click **AI Generate** to auto-create from your content
3. FAQ schema is automatically generated when published

**Best practices:**

* **5-8 FAQs per post** is optimal
* Keep answers to **2-3 sentences** - concise and direct
* FAQ schema gives you **2-3x more SERP real estate** with dropdown snippets in Google

***

#### Gallery <a href="#gallery" id="gallery"></a>

Display a collection of images in a grid or slider layout. Configure aspect ratios, card layouts, alt text, and captions.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FFry0NsPWJSUoqx3nYAgM%2Fgallery.jpg?alt=media&#x26;token=8e7125a5-2e30-47d5-89b2-4f37085c3532" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Gallery element or type `/gallery`
2. Upload or select multiple images
3. Choose layout: Grid or Slider
4. Configure aspect ratios and captions

**Best practices:**

* **3-9 images** per gallery
* Add alt text to every image
* Use **consistent aspect ratios** for a clean look

***

#### Text & Image <a href="#text--image" id="text--image"></a>

A two-column layout combining text and images. Supports multiple images for a carousel effect and inline buttons.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FF9pvlB3ceRWVt0TeX9GX%2Ftextimage.jpg?alt=media&#x26;token=ec2fef5e-6ab0-4e03-ad1a-8de352dfae16" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Text & Image element or type `/text & image`
2. Write text on one side
3. Add images on the other (supports carousel)
4. (Optional) Add a button within the layout

**Best practices:**

* Text left, image right is the standard pattern
* Best for: product storytelling, feature showcases, tutorials

***

#### Custom HTML <a href="#custom-html" id="custom-html"></a>

Insert custom HTML code directly into your post. Use for embedding third-party widgets, custom styling, or content that requires raw HTML.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F5djjfKtIqwo1jtXSifwf%2Fimage.png?alt=media&#x26;token=eb1851b5-9548-4ccd-9a22-2457ed49e569" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Custom HTML element or type `/html`
2. Paste your HTML code
3. Preview to ensure it renders correctly

**Supported use cases:** Klaviyo forms, Typeform surveys, Google Maps, Calendly embeds, custom CSS styling.

**Best practices:**

* Keep HTML **minimal and clean**
* Test thoroughly before publishing
* Avoid conflicting JavaScript

***

#### Decoration <a href="#decoration" id="decoration"></a>

Add decorative visual elements to your post using AI-powered templates.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FQoBTa5OWJ50YakDA8dC6%2Fimage.png?alt=media&#x26;token=35f4d8c4-f498-4886-8326-57ec618a7160" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Decoration element or type `/decoration`
2. Describe the style you want with specific bullet points (colors, materials, lighting style, mood)
3. AI generates the decorative visual

**Best practices:**

* Use **sparingly**: 1-2 per post max
* Be specific in your descriptions for better results
* Best for: brand identity visuals, seasonal theming, hero sections

***

### Social Embeds <a href="#social-embeds" id="social-embeds"></a>

#### Instagram <a href="#instagram" id="instagram"></a>

Embed Instagram posts or Reels directly in your blog post.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FyIH0Wn6L5keVsNjyHMAi%2Fimage.png?alt=media&#x26;token=a373d8e8-756b-4182-ad8b-ba3334f64b45" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add an Instagram element or type `/instagram`
2. Paste the Instagram post or Reel URL
3. The content appears inline

**Best practices:**

* Limit to **1-3 embeds** per post (each adds external scripts affecting load time)
* Ensure the post is **public** - private posts won't display
* Best for: user-generated content (UGC), influencer collaborations

***

#### TikTok <a href="#tiktok" id="tiktok"></a>

Embed TikTok videos in your blog post.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FTBJqs0HNM1pHT0m4KqrI%2Fimage.png?alt=media&#x26;token=e1720095-a9a9-44bf-832a-19b7df8b38cd" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a TikTok element or type `/tiktok`
2. Paste the TikTok video URL
3. The video embeds inline

**Best practices:**

* Limit to **1-2 per post** (external scripts impact load time)
* Ensure the video is **public**
* Best for: product demos, tutorials, trend content, Gen Z audience

***

#### X (Twitter) <a href="#x-twitter" id="x-twitter"></a>

Embed tweets from X (formerly Twitter) in your blog post.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F8yuPZN7KF2EEGkDBV970%2Fimage.png?alt=media&#x26;token=1e485b9b-7da5-418d-823e-a8fb2bd4a659" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add an X element or type `/x`
2. Paste the tweet URL
3. The tweet embeds inline

**Best practices:**

* **1-3 tweets per post**
* Add your own commentary before the embed for context
* Best for: expert authority, social proof, news references, announcements

***

### Recipe Elements <a href="#structured-data-elements" id="structured-data-elements"></a>

Format cooking or preparation instructions with full Google Recipe schema compliance. When published, this generates rich results in Google search with cooking details, ratings, and images.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2FGZvEb4qA7u0tlc0sFN1g%2Fimage.png?alt=media&#x26;token=7fe4c31c-6201-4c13-ba31-5bada1d59d16" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Recipe element or type `/recipe`
2. Fill in: recipe title, description, prep/cook/total time
3. Add ingredients list and step-by-step instructions
4. Set servings, calories, and nutrition info
5. Recipe schema is automatically generated

**Best practices:**

* Link to your products in the ingredients list (e.g., link "olive oil" to your store's olive oil)
* Recipe content has the **highest click-through rates** of any content type in Google

***

#### Image Compare <a href="#image-compare" id="image-compare"></a>

Create an interactive before-and-after comparison slider. Readers drag a handle to reveal two overlapping images.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F3I9xniCHnN1rG9Bwecly%2Fimage.png?alt=media&#x26;token=d6ba80f7-3742-48f3-ab35-2e4503d896d7" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add an Image Compare element or type `/imagecompare`
2. Upload the "before" and "after" images
3. Choose slider orientation: horizontal or vertical
4. Configure aspect ratio and optional custom CSS

**Best practices:**

* Use **consistent lighting and angle** for both images
* Label images clearly ("Before" / "After")
* Best for: product demos, skincare results, home improvement, design transformations

***

#### Event Countdown <a href="#event-countdown" id="event-countdown"></a>

Add a countdown timer for upcoming events, product launches, sales, or promotions.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2Flbw5ZShGDPCGEe2dRpot%2Fimage.png?alt=media&#x26;token=0e9aa812-1df7-4efc-94b3-53c66fd8c12d" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add an Event Countdown element or type `/countdown`
2. Set: event title, description, countdown date and time
3. Add a link to the event page or product
4. (Optional) Set a custom message for when the countdown expires

**Best practices:**

* Creates **FOMO urgency** that drives action
* **Remove or update** after the event ends
* Best for: product launches, flash sales, seasonal events, webinars

***

#### Map <a href="#event-countdown" id="event-countdown"></a>

Embed a Google Maps location directly in your blog post. Useful for store locators, travel guides, event venues, or any location-based content.

<figure><img src="https://386309109-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAmPCDHs9RbAEkSoOXwBB%2Fuploads%2F7BUP0CNab2cSe0nKdR2I%2Fimage.png?alt=media&#x26;token=f1d217bc-2447-4e24-9952-66d4fd08801e" alt=""><figcaption></figcaption></figure>

**How to use:**

1. Add a Map element or type `/map`
2. Search for a location in the **Search location** field
3. The map renders inline with a Google Maps pin

**Settings:**

* **Alignment:** Left, Center, or Right
* **Aspect Ratio:** 16:9 (default), or custom
* **Width:** Adjust percentage width
* **Zoom:** Control map zoom level
* **Custom CSS:** Add custom styling if needed

**Best practices:**

* Use for **store locations, event venues, travel guides**
* Set a reasonable **zoom level** - too close loses context, too far hides the pin
* 16:9 aspect ratio works best for most layouts


---

# Agent Instructions: 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:

```
GET https://help.seoon.io/element/advanced-elements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
