App Embed Installation

Not Recommended

App Embeds only work with approximately 80% of Shopify themes. We strongly recommend using Theme Blocks instead for guaranteed compatibility.

App Embeds provide automatic placement but with less control and reliability than Theme Blocks.

When to Use App Embed

Consider App Embed only if:

• You want the fastest possible setup
• You're just testing the app temporarily
• Your theme doesn't support Theme App Extensions (rare)

How App Embed Works

App Embeds use JavaScript to automatically detect your product page structure and inject the FAQ panel in what the app believes is the optimal location. This works well with most themes but can fail or misplace content with:

• Heavily customized themes
• Themes with non-standard HTML structure
• Single-page application (SPA) themes
• Some older or boutique themes

Installation Steps

Step 1: Open Theme Editor

1. Go to Online Store → Themes in your Shopify admin
2. Click Customize on your active theme

Step 2: Open App Embeds

1. Click the App embeds icon in the left sidebar (puzzle piece icon)
2. Find Convertiko FAQ in the list
3. Toggle the switch to enable it

Step 3: Save and Test

1. Click Save
2. Visit a product page that has generated FAQ content
3. Check if the FAQ appears in a reasonable location

Troubleshooting App Embed

FAQ Not Appearing

If the FAQ doesn't appear at all:

1. Check console for errors: Open browser DevTools (F12) → Console tab
2. Verify product has content: The embed only shows if FAQ content exists
3. Check embed is enabled: Return to theme editor → App embeds

FAQ in Wrong Position

This is the most common issue with App Embeds. The embed tries to find the product description or add-to-cart button, but themes vary widely in their HTML structure.

Solutions:

1. Switch to Theme Block installation (recommended)
2. Use Manual installation for precise control

FAQ Appears Multiple Times

Some themes have duplicate product sections. The embed may detect multiple insertion points.

Solution: Switch to Theme Block installation for precise control.

Switching to Theme Block

If you're experiencing issues with App Embed:

1. Go to Theme editor → App embeds
2. Toggle Convertiko FAQ to off
3. Follow the Theme Block installation guide

Your FAQ content and settings will remain intact—you're just changing the display method.

Technical Details

The App Embed works by:

1. Detecting product pages via URL pattern (/products/*)
2. Finding the product information section via common selectors
3. Injecting the FAQ container after the detected element
4. Loading FAQ content for the current product

Selectors Used

The embed looks for these elements in order:

product-info
.product__info-container
.product-info
.product-single__meta
.product-description
form[action*="/cart/add"]

If your theme uses non-standard class names, the embed may not find the correct location.

Next Steps

• Theme Block Installation (Recommended)
• Manual Installation
• Generating Content