> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/features/product-faqs/shopify-setup.md).

# Shopify Setup

### 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**

<figure><img src="/files/Z8hclYmdm7s7UhV4DXlE" alt=""><figcaption></figcaption></figure>

### 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**

<figure><img src="/files/teXnAAhLjOUWXWiNjg6R" alt=""><figcaption></figcaption></figure>

### 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

<figure><img src="/files/tc0IGGvCmIslhPKXT2vP" alt=""><figcaption></figcaption></figure>

### 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.