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


---

# 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://alhena.gitbook.io/docs/features/product-faqs/shopify-setup.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.