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

# Help & Support

> Find answers to common questions and get help with BubblaV

Find answers to frequently asked questions about BubblaV. If you need additional help, [contact our support team](https://www.bubblav.com/contact).

## Getting Started

<AccordionGroup>
  <Accordion title="How do I create an account?">
    Visit [bubblav.com](https://www.bubblav.com) and click **Sign Up**. You'll need to verify your email before you can start using the platform.
  </Accordion>

  <Accordion title="How do I add my website?">
    After logging in, go to **Dashboard** → **Websites** and click **Add Website**. Enter your website URL and BubblaV will automatically start crawling your content.
  </Accordion>

  <Accordion title="How long does it take to set up?">
    You can have a basic chatbot running in 5-10 minutes. Website crawling typically takes 2-5 minutes depending on your site size, and you can continue configuring while it runs.
  </Accordion>

  <Accordion title="What happens after I add my website?">
    1. BubblaV automatically crawls your website to learn your content
    2. Your knowledge base is populated with indexed pages
    3. A unique embed code is generated for your website
    4. You can customize the widget and test it before going live
  </Accordion>

  <Accordion title="Do I need to install anything on my server?">
    No installation on your server is required. You just need to add a small JavaScript snippet to your website's HTML. See the Installation guide for platform-specific instructions.
  </Accordion>
</AccordionGroup>

## Installation & Widget Deployment

<AccordionGroup>
  <Accordion title="How do I install the widget on my website?">
    1. Go to **Dashboard** → **Installation**
    2. Copy the embed code provided
    3. Paste it into your website's HTML (typically in the footer or header)
    4. The widget will appear on your live site within minutes
       For platform-specific instructions, see the Installation guide.
  </Accordion>

  <Accordion title="Can I install the widget on WordPress?">
    Yes! You can use the "Insert Headers and Footers" plugin to paste the embed code in the footer section, or manually add it to your theme's footer.php file.
  </Accordion>

  <Accordion title="Can I install the widget on Shopify?">
    Yes! Install the BubblaV Shopify app from the App Store. It will automatically integrate with your store and you can configure it from your dashboard.
  </Accordion>

  <Accordion title="Why isn't my widget appearing?">
    * Verify the embed code is correctly placed in your HTML
    * Check your browser console for errors
    * Ensure you're using the correct website ID
    * Wait a few minutes for the widget to load
    * Check that your website ID is active in your dashboard
  </Accordion>

  <Accordion title="Can I change the widget position?">
    Yes. Go to **Design** → **Positioning** and choose **Bottom Right** or **Bottom Left** for both desktop and mobile.
  </Accordion>
</AccordionGroup>

## Knowledge Base & Training

<AccordionGroup>
  <Accordion title="What is website crawling?">
    Website crawling automatically scans your website, extracts content from your pages, and makes it searchable so your chatbot can answer questions accurately based on your actual content.
  </Accordion>

  <Accordion title="How does crawling work?">
    When you add a website, BubblaV:

    1. Visits your URL and extracts all text content
    2. Follows links to discover other pages on your domain
    3. Detects sitemaps and crawls listed URLs
    4. Processes content into searchable chunks
    5. Updates status for each page (Crawled, Pending, Failed)
  </Accordion>

  <Accordion title="Can I crawl websites other than my main site?">
    Yes! You can add sub-websites and external domains to your knowledge base. This allows you to train your chatbot on content from multiple related sources.
  </Accordion>

  <Accordion title="What if my website blocks bots?">
    Check your robots.txt file. BubblaV respects the robots.txt standard, so pages blocked there won't be crawled. If needed, you can manually add content using text snippets or file uploads.
  </Accordion>

  <Accordion title="Can I upload files to train the bot?">
    Yes! You can upload PDFs, documents, and text files directly to your knowledge base. Go to **Knowledge** → **Files** to upload content.
  </Accordion>

  <Accordion title="How do I add specific answers to common questions?">
    Use **Knowledge** → **Q\&A** to add specific entries. Write out question and answer pairs you want the chatbot to know.
  </Accordion>
</AccordionGroup>

## Widget Customization & Design

<AccordionGroup>
  <Accordion title="How do I customize the widget appearance?">
    Go to **Design** in your dashboard to customize:

    * Brand colors and color themes
    * Widget size and position
    * Welcome message and chat suggestions
    * Bot name and avatar
    * Background styles
  </Accordion>

  <Accordion title="Can I auto-detect my brand colors?">
    Yes! When you add a new website, BubblaV automatically analyzes your site's colors and applies a matching theme. You can also manually extract colors anytime: go to **Design** → **Color Palette Presets**, enter any URL, and click **Extract Colors**.
  </Accordion>

  <Accordion title="Can I change the bot's name and avatar?">
    Yes. Go to **Design** → **Home Screen** to customize the bot's name, avatar image, and welcome message.
  </Accordion>

  <Accordion title="Can I remove the 'Powered by BubblaV' branding?">
    Yes, this option is available on Pro+ plans. Go to **Design** → **General** and toggle **Show 'Powered by' branding**.
  </Accordion>

  <Accordion title="What sizes can I set for the widget?">
    * **Width**: Default is 400px (adjustable)
    * **Height**: Default is 650px (adjustable)
      You can customize dimensions to match your website's design.
  </Accordion>
</AccordionGroup>

## Integrations

<AccordionGroup>
  <Accordion title="Why should I connect Shopify?">
    Connecting Shopify enables your chatbot to:

    * Track orders by order number
    * Search your product catalog
    * Show product details
    * Access customer order history
    * Process returns and refunds
    * Check gift card balances
    * Validate discount codes
  </Accordion>

  <Accordion title="How do I connect Shopify?">
    1. Go to **Dashboard** → **Integrations** → **Shopify**
    2. Click **Connect Shopify**
    3. The BubblaV app will open in the Shopify App Store
    4. Click **Install** and authorize the app
    5. You'll be redirected back to your dashboard
  </Accordion>

  <Accordion title="Why did my Shopify connection fail?">
    * Verify you're using your `.myshopify.com` domain
    * Check that your store is active
    * Clear browser cache and try incognito mode
    * Ensure you have app installation permissions
    * Try the authorization process again
  </Accordion>

  <Accordion title="What integrations are available?">
    BubblaV supports integrations with: Shopify, HubSpot, Zendesk, Calendly, Stripe, Klarna, Polar, and custom tools via our MCP servers.
  </Accordion>

  <Accordion title="How do I set up a custom integration?">
    Use **Custom Tools** to create HTTP requests to any API. You can define tools that call external services and integrate them into your chatbot.
  </Accordion>
</AccordionGroup>

## Live Support

<AccordionGroup>
  <Accordion title="What is live support?">
    Live support lets you take over conversations in real-time when a customer needs to talk to a human. This feature is available on Pro+ plans.
  </Accordion>

  <Accordion title="How do I enable live support?">
    Live support is automatically enabled for Pro+ plan users. Your team members can access the **Live Support** dashboard to see and respond to conversations in real-time.
  </Accordion>

  <Accordion title="Who can access live support?">
    Your account owner can add team members with different roles. Go to **Team & Members** to manage who can access live support conversations.
  </Accordion>
</AccordionGroup>

## Account & Billing

<AccordionGroup>
  <Accordion title="What plans does BubblaV offer?">
    BubblaV offers three plans with different features and pricing. Visit the [Pricing page](https://www.bubblav.com/pricing) to see all available plans and their features.

    **Pricing Summary:**

    * **Free**: \$0/month (100 messages/month, 1 website, 50 pages)
    * **Pro**: \$49/month (\$39/month annually, save \$120/year, 5,000 messages/month) - 14-day free trial
    * **Turbo**: \$99/month (\$79/month annually, save \$240/year, 15,000 messages/month)

    All paid plans include annual billing options with 20% savings compared to monthly billing.
  </Accordion>

  <Accordion title="Do you offer a free trial?">
    Yes! The Pro plan includes a **14-day free trial** for new customers. You get full access to all Pro features during the trial period. Your payment card is required at signup but won't be charged until the trial ends. Cancel anytime during the trial at no cost.
  </Accordion>

  <Accordion title="How do I upgrade or downgrade my plan?">
    You can change your plan anytime from your **Account Settings** → **Billing**. Upgrades are effective immediately, and downgrades take effect at the end of your billing cycle.
  </Accordion>

  <Accordion title="What happens when my subscription expires?">
    Your website will stop working until you renew your subscription. Your data is preserved, so you can resume service anytime by renewing.
  </Accordion>

  <Accordion title="Do you offer refunds?">
    Contact our [support team](https://www.bubblav.com/contact) to discuss your options. We may be able to help depending on your situation.
  </Accordion>

  <Accordion title="How do I add team members?">
    Go to **Team & Members** in your dashboard and click **Add Member**. Enter their email address and select their role. They'll receive an invitation to join your account.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The chatbot isn't answering questions correctly">
    * Verify your website was fully crawled (check Knowledge → Pages)
    * Add specific Q\&A pairs for common questions you want answered
    * Upload relevant documents to your knowledge base
    * Use "Content Gaps" to identify what information is missing
    * Test with specific questions from your website content
  </Accordion>

  <Accordion title="The bot responses are too generic">
    Your knowledge base may not have enough specific information. Consider:

    * Adding more detailed content to your website
    * Uploading PDFs with detailed product/service information
    * Adding Q\&A entries with specific question/answer pairs
    * Refining behavior in Settings
  </Accordion>

  <Accordion title="Email verification not received">
    * Check your spam/junk folder
    * Verify you entered the correct email address
    * Request a new verification email
    * Try signing up with Google instead
  </Accordion>

  <Accordion title="The crawl is taking too long">
    * Large websites (100+ pages) naturally take longer
    * Check if your site blocks bots in robots.txt
    * Try adding pages manually if crawl continues to fail
    * Contact support if crawl is stuck
  </Accordion>

  <Accordion title="I can't access my dashboard">
    * Verify you're using the correct login credentials
    * Try resetting your password
    * Check that your browser supports the dashboard
    * Clear your browser cache and try again
    * Contact support if you're still unable to access
  </Accordion>

  <Accordion title="The widget is loading slowly">
    * Check your internet connection
    * Verify the widget code is correctly installed
    * Check browser console for JavaScript errors
    * Ensure your website's server is responding quickly
    * Try clearing your browser cache
  </Accordion>
</AccordionGroup>

## Still Need Help?

If you can't find the answer you're looking for, we're here to help! [Contact our support team](https://www.bubblav.com/contact) and we'll respond as quickly as possible.

You can also check the [User Guide](/user-guide/getting-started) for more detailed documentation.