Installing Product FAQs in Shopify

This guide walks you through adding the Product FAQs block to your Shopify store's product pages.

Prerequisites

Before adding the Product FAQs block, ensure you have:

  1. Installed the Alhena app on your Shopify store

  2. Enabled Product FAQ in your Alhena dashboard

Step 1: Enable the Alhena App Embed

The main Alhena app embed must be enabled for the Product FAQs block to function.

  1. In your Shopify admin, go to Online Store > Themes

  2. Click Edit theme on your active theme

  3. In the theme editor, click App embeds (puzzle piece icon in the left sidebar)

  4. Find Alhena AI Chat Widget and toggle it ON

  5. Click Save

Step 2: Add the Product FAQs Block

  1. In the theme editor, navigate to a Product page template

    • Use the page selector dropdown at the top to choose "Products" > "Default product"

  2. Choose the section where you want to display FAQs (e.g., Product information, or add a new section)

  3. Click Add block within that section

  4. Under Apps, select Alhena Product FAQs

  5. Drag the block to position it where you want the FAQs to appear

  6. Click Save

Step 3: Verify the Installation

Once installed, the block will display FAQs for products that have them configured in your Alhena dashboard.

  • In the theme editor: You'll see a placeholder message if no FAQs are configured

  • On your live store: FAQs will display automatically for products with FAQ content

Troubleshooting

FAQs not appearing

  1. Verify the Alhena AI Chat Widget app embed is enabled (Step 1)

  2. Confirm Product FAQ is enabled in your Alhena dashboard

Block not available in theme editor

The Product FAQs block only appears when editing Product page templates. Make sure you're on a product template, not the homepage or other page types.

Last updated