> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Quick answers to the most common questions about homie — setup, assistants, knowledge, billing, privacy, and more.

Quick answers to the most common questions about homie. Browse by topic below, or use search to jump straight to an answer.

## General

<AccordionGroup>
  <Accordion title="What is homie?">
    homie is an AI-powered chat assistant embedded on your e-commerce store. It answers product and support questions, recommends products, and guides shoppers toward checkout — all from your storefront. Learn more in the [Introduction](/en/user-guide/quick-start/introduction).
  </Accordion>

  <Accordion title="Which platforms are supported?">
    homie is added with a single embed script, so it works on essentially any shop system or website where you can add a snippet of code. For the most common platforms — Shopify, Shopware, WooCommerce, Magento, and WordPress — we also provide step-by-step guides, and there's a REST API for custom storefronts and apps. See the [Installation overview](/en/user-guide/installation/overview).
  </Accordion>

  <Accordion title="How long does setup take?">
    About 10 minutes for most stores. Shopify is essentially one-click, and other platforms use a simple drop-in script. Follow the [Quickstart](/en/user-guide/quick-start/getting-started) for the full path.
  </Accordion>

  <Accordion title="Where is my data hosted?">
    homie is hosted entirely in the EU and is GDPR-compliant by default. See [Privacy & Security](#privacy--security) below for details.
  </Accordion>

  <Accordion title="Do I need developers to install it?">
    No. Shopify installs with one click, and other platforms only require pasting a small script — for example via Google Tag Manager. Developers can optionally use the REST API for deeper integrations.
  </Accordion>

  <Accordion title="What languages does the chatbot support?">
    homie understands and replies in many languages and can respond in the shopper's own language. You can also tailor wording per assistant. See [Translations](/en/user-guide/assistants/translations).
  </Accordion>
</AccordionGroup>

## Assistants

<AccordionGroup>
  <Accordion title="Can I have multiple assistants?">
    Yes. You can create multiple assistants in your workspace — for example one per brand, region, or use case — each with its own knowledge, tone, and appearance. See the [Assistants overview](/en/user-guide/assistants/overview).
  </Accordion>

  <Accordion title="How do I change the assistant's tone or personality?">
    Use the assistant's fine-tuning instructions to set its tone, what to emphasize, and what to avoid. Clear, specific guidance produces on-brand answers. See [Fine-tuning](/en/user-guide/assistants/fine-tuning).
  </Accordion>

  <Accordion title="How do I test it before going live?">
    Use the Playground to chat with your assistant exactly as a shopper would, and refine it until the answers feel right — all before it's installed on your store. See the [Playground](/en/user-guide/assistants/playground).
  </Accordion>

  <Accordion title="Can I control where the widget appears?">
    Yes. Page configuration lets you decide which pages show the widget and where proactive messages trigger. See [Page configuration](/en/user-guide/assistants/page-configuration).
  </Accordion>

  <Accordion title="How do I customize its appearance?">
    You can adjust colors, branding, and widget behavior to match your store. See [Appearance](/en/user-guide/assistants/appearance) and [Widget behavior](/en/user-guide/assistants/widget-behavior).
  </Accordion>
</AccordionGroup>

## Knowledge

<AccordionGroup>
  <Accordion title="What can I train the assistant on?">
    You can train homie on websites, files, FAQs, free text, and your product feed. Together these give the assistant the context it needs to answer accurately. See the [Knowledge overview](/en/user-guide/knowledge/overview).
  </Accordion>

  <Accordion title="How often is knowledge refreshed or retrained?">
    homie keeps your sources in sync so answers reflect your latest content. After major catalog or policy changes, review your sources to confirm everything is up to date. See [Sources](/en/user-guide/knowledge/sources/website).
  </Accordion>

  <Accordion title="What is a knowledge store versus product data?">
    A knowledge store holds general content — websites, files, FAQs, and text. Product data is your catalog of items, prices, and availability used for recommendations. They work together. See [Knowledge stores](/en/user-guide/knowledge/knowledge-stores) and [Product data](/en/user-guide/knowledge/product-data).
  </Accordion>

  <Accordion title="Why isn't the assistant answering about a product?">
    Usually the product data isn't connected or fully synced, or the relevant detail isn't in a knowledge source. Check that your product data is connected and that the information exists in your sources. See [Product data](/en/user-guide/knowledge/product-data).
  </Accordion>
</AccordionGroup>

## Installation

<AccordionGroup>
  <Accordion title="How do I add the widget to my site?">
    Install the widget for your platform using the relevant guide. Most platforms only need a small script added once. Start with the [Installation overview](/en/user-guide/installation/overview).
  </Accordion>

  <Accordion title="Do I need an app for Shopify?">
    Shopify is the simplest path and installs with minimal setup. Follow the [Shopify installation guide](/en/user-guide/installation/shopify).
  </Accordion>

  <Accordion title="Can I connect multiple Shopify stores?">
    Yes. Open **Integrations → Shopify**, select **Add store**, and install the homie app in each additional store. You can manage permissions and conversion tracking separately for every store and select the matching Shopify store as each assistant's product source. See the [Shopify integration](/en/user-guide/integrations/shopify).
  </Accordion>

  <Accordion title="Can I install via Google Tag Manager?">
    Yes. If you already use Google Tag Manager, you can add the homie script as a tag without editing your theme. See [Google Tag Manager](/en/user-guide/installation/google-tag-manager).
  </Accordion>

  <Accordion title="Why isn't the widget showing up?">
    Common causes include the script not being added to every page, caching, or a content blocker. Confirm the script is present and clear your cache. For platform-specific steps, revisit your platform's guide under the [Installation overview](/en/user-guide/installation/overview).
  </Accordion>
</AccordionGroup>

## Billing

<AccordionGroup>
  <Accordion title="How does pricing work?">
    homie uses plans with a monthly message quota. You pick a plan that fits your expected volume and can change it as your store grows. See [Billing](/en/user-guide/settings/billing) and [Usage](/en/user-guide/settings/usage).
  </Accordion>

  <Accordion title="What happens when I hit my message limit?">
    When you reach your plan's message quota, you can upgrade to a higher plan or, where enabled, allow capped usage to keep the assistant running. Review your current consumption under [Usage](/en/user-guide/settings/usage).
  </Accordion>

  <Accordion title="How do I upgrade or downgrade?">
    Change your plan anytime on the platform under billing settings. Upgrades take effect immediately so you get more capacity right away. See [Billing](/en/user-guide/settings/billing).
  </Accordion>

  <Accordion title="How does Shopify billing work?">
    Your organization has one homie subscription, carried by one connected Shopify store. Other connected stores do not need a separate subscription. The Billing page shows the billing store, and you can transfer billing to another connected store before disconnecting it. See [Billing](/en/user-guide/settings/billing).
  </Accordion>

  <Accordion title="What is capped usage?">
    Capped usage lets the assistant keep handling conversations beyond your included quota up to a limit you control, so you avoid surprise overages while staying live. See [Usage](/en/user-guide/settings/usage).
  </Accordion>
</AccordionGroup>

## Privacy & Security

<AccordionGroup>
  <Accordion title="Where is data stored?">
    homie is hosted entirely in the EU. Your data and your customers' data stay within EU infrastructure.
  </Accordion>

  <Accordion title="Is homie GDPR-compliant?">
    Yes. homie is built to be GDPR-compliant by default, with EU-only hosting and data handling designed around EU privacy requirements.
  </Accordion>

  <Accordion title="How is customer data handled?">
    Conversations are designed to provide responses for advisory purposes and to give you analytics on what shoppers are asking. No personal data is processed in this context, and chat data is processed within the EU and in accordance with the GDPR.
  </Accordion>

  <Accordion title="Can I delete my data or organization?">
    Yes. You can remove content and delete your organization from the platform. See [Workspace settings](/en/user-guide/settings/workspace).

    <Warning>
      Deleting your organization is permanent and removes its assistants, knowledge, and conversation history. Export anything you need first.
    </Warning>
  </Accordion>

  <Accordion title="Is the API secured?">
    Yes. The REST API is authenticated — requests use an `x-api-key` header. Keep your keys secret and rotate them if exposed. See [Secrets](/en/user-guide/settings/secrets) and the [API reference](/en/api-reference/client/overview).
  </Accordion>
</AccordionGroup>