Product Q&A for Shopify

The widget does not appear on the product page

• → Verify that the plugin is activated in Dashboard → Plugins → Product Q&A
• → Check that your domain is on the list of authorized domains
• → Verify that Shopify is connected to WAzion
• → Open the browser console (F12 → Console) and look for errors in red
• → Test in incognito window to rule out cache issues

Invalid token“ or “Unauthorized domain“ error

• → Copy the token directly from the Dashboard, without spaces
• → Add your exact domain to the authorized ones: mitienda.myshopify.com And mitienda.com
• → Wait a few seconds after saving changes on the Dashboard

The widget appears but says “Error loading product

• → Verify that Shopify is connected in Dashboard → Integrations
• → Make sure you have not modified {{ product.id }} in the code
• → The product must be published and visible in the store

The widget appears in the wrong place

• → Move the code to another location in main-product.liquid
• → Look for references like “product__description“ to place it underneath
• → Use the margin style in the div to adjust spacing: style=“margin: 30px 0;

I don’t know which file to edit in my theme

Common files by topic:

• Dawn, Craft, Sense: sections/main-product.liquid
• Debut: sections/product-template.liquid
• Brooklyn: templates/product.liquid
• Minimal: sections/product-template.liquid

If your topic is not on the list, look for files containing “product“ in Sections or Templates.

Authorized Domains

List of domains where the widget can operate. For security reasons, use is only allowed from authorized domains.

• • mitienda.myshopify.com
• • mitienda.com (custom domain)
• • * (any domain - for development only)

Design Topics

10 pre-designed themes to customize the widget for your store:

Widget Texts

Customize the texts that the visitor sees:

• • Widget title (e.g., “Questions about this product“)
• • Text field placeholder
• • Ask button text

The texts are automatically translated into the visitor’s language.

Instructions for the AI (optional)

You can add additional information that the AI will take into account when responding:

• • Shipping and Return Policies
• • Active promotions
• • Special instructions (e.g., “Do not mention competitor products“)
• • Contact Information

Language Settings

Anti-Abuse Protection

Limit the number of questions per visitor to protect your account:

• • Maximum number of questions per period (e.g., 20 questions)
• • Time window in minutes (e.g., 60 minutes)

Usage metrics

• • Total questions
• • Questions in the last 7 days
• • Today’s questions
• • Unique visitors (24h)

Most Viewed Products

View a ranking of the 5 products with the most questions. Useful for identifying which products generate the most inquiries.

Question Viewer

Review all the questions asked by the visitors:

• • Filter by period: Today, 7 days, 30 days, 90 days, 1 year, all, or custom range
• • Paginated list: Browse through all the questions (10 per page)
• • Full detail: See question, AI answer, product, language, and URL
• • FAQ status: Each question shows whether it is already published as an FAQ
• • Manual publish: Post any question as a FAQ with one click

What is the Public FAQ?

When a customer asks a generic question about a product (for example: “Is it waterproof?“ or “What is the shipping time?“), the AI evaluates whether that question and answer would be useful for other customers.

If the AI decides that it is a good FAQ, it is automatically published in the product metafield in Shopify. Then you can display these FAQs in your theme with the Liquid code we provide.

How it works

1. 1

   AI Evaluation

   When a customer asks a question, the AI evaluates whether it is generic (useful for others) and does not contain personal data.

2. 2

   Automatic translation

   If the customer asks in another language, the FAQ is automatically translated into your store’s primary language.

3. 3

   Anti-duplicates

   It is verified that a similar FAQ (80% similarity) does not already exist before publishing.

4. 4

   Shopify Post

   The FAQ is saved in the product’s wazion.faqs metafield, ready to display in your theme.

How to activate the Public FAQ

1. Go to Dashboard → Plugins → Product Q&A
2. Look for the section “FAQ Public in Shopify
3. Activate the “Enable public FAQ“ switch
4. If a permission prompt appears, click on “Verify permission
5. Set the maximum number of FAQs per product (1-20)
6. Save the changes

Management of published FAQs

Although the FAQs are published automatically, you have full control from the Dashboard:

• • See FAQs: List of all published FAQs, filtered by product or status
• • Manual publish: From Latest Questions you can publish any question as an FAQ with one click
• • Unpublish Remove a Shopify FAQ but keep it in your history
• • Republish: Republish a previously unpublished FAQ
• • Delete Permanently delete a FAQ

Show FAQs in your Shopify theme

You need to add two codes in your main-product.liquid file:

<!-- WAzion Product FAQs -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<div class="product-faqs">
  <h3 class="product-faqs__title">Preguntas Frecuentes</h3>
  {% for faq in faqs_data.faqs %}
  <details class="product-faqs__item">
    <summary class="product-faqs__question">{{ faq.q }}</summary>
    <div class="product-faqs__answer">{{ faq.a | newline_to_br }}</div>
  </details>
  {% endfor %}
</div>
{% endif %}

<!-- WAzion FAQs JSON-LD for SEO -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {% for faq in faqs_data.faqs %}
    {
      "@type": "Question",
      "name": {{ faq.q | json }},
      "acceptedAnswer": {
        "@type": "Answer",
        "text": {{ faq.a | json }}
      }
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ]
}
</script>
{% endif %}

Which questions are NOT published?

AI automatically filters out questions that are not suitable for the public FAQ.

• ✗ Questions with personal data (names, emails, phone numbers)
• ✗ Inquiries about specific orders (order numbers, tracking)
• ✗ Individual complaints or issues
• ✗ Very specific questions that would not apply to other clients
• ✗ Duplicate questions (similar to already published FAQs)