Docs FAQ

Frequently Asked Questions

Common questions about brng.ai — setup, data, security, performance, and billing.

On this page

General

What is brng.ai?

brng.ai is an AI-powered search platform that adds an intelligent search assistant to your website. It uses Retrieval-Augmented Generation (RAG) to answer visitor questions using your actual product catalog and website content — not generic AI responses.

What is RAG?

RAG (Retrieval-Augmented Generation) combines information retrieval with AI text generation. Instead of relying solely on a model's training data, RAG first retrieves relevant documents from your indexed content and uses those as context — so every response is grounded in your real data.

What types of businesses is it for?

Any business with a website and content to search. E-commerce stores (Shopify, Magento), content websites (docs, blogs, knowledge bases), and organizations (membership directories, event listings, policy databases). Two modes: E-commerce for product catalogs and Content for general websites.

Can I use it on multiple websites?

Yes. Each website is a separate "domain" in your organization, each with its own configuration, data, analytics, and subscription. Switch between domains from the sidebar picker.

What platforms does it integrate with?

Native integrations for Shopify (GraphQL Admin API with metafield support) and Magento 2 (REST API with OAuth 1.0a authentication). For other platforms, the standard website importer indexes any public webpage. Custom database connections are also available for non-standard data sources.

Data & Import

What data sources are supported?

Product data: Shopify (GraphQL Admin API), Magento 2 (REST API with OAuth), custom database connections (MySQL, PostgreSQL), CSV/Excel upload. Website content: Standard website import, advanced import for JS-heavy sites, plus platform-specific importers for Shopify and Magento.

How often is my data updated?

Product syncs and website imports can be scheduled on configurable intervals — daily, weekly, biweekly, or monthly. You can also trigger a manual sync or import at any time from the dashboard. A full re-sync option is available to re-import all products from scratch.

Can I control what gets imported?

Yes. You can set starting URLs, import depth, URL exclusion patterns, and whether to honor robots.txt. Advanced options include page limits, JavaScript rendering mode, and concurrent request limits.

Does it support custom product fields?

Yes. For Shopify, you can discover and select metafields to include in search results. For Magento, custom product attributes are supported with the same workflow. Each field can be toggled as "searchable" (included in the AI's knowledge) or metadata-only (stored but not searched).

What happens when I first register?

A website import starts automatically in the background, indexing your pages right away. For e-commerce sites, you'll be guided through connecting your store and importing products as part of the onboarding checklist.

Security

Is my data secure?

Yes. The platform uses encrypted session tokens for search app communication, JWT sessions for the dashboard, role-based access control (5 roles), AES-256-GCM encryption for sensitive database fields, CORS protection, rate limiting on all public endpoints, and optional Cloudflare Turnstile bot protection.

Is the AI server exposed to the internet?

No. The AI server is internal only. All traffic from the search app goes through the dashboard API, which acts as a secure proxy. The AI server is never directly accessible from the internet.

What user roles are available?

Role Access Level
Super Admin All features across all organizations — platform settings, global prompts, partner program
Org Admin Full access within their organization across all domains
Admin Full access within their assigned domain
Editor Modify prompts, stop words, and search app customization
Viewer Read-only access to dashboards and analytics

Can I restrict access by IP?

Yes. IP whitelisting is available in Settings > Security. Only requests from whitelisted IPs will be processed.

Performance

How fast are responses?

Streaming starts within 1-2 seconds of a question. The full answer typically completes in 2-4 seconds. The search app shows real-time status updates during processing (searching, ranking, generating) so visitors always know what's happening.

Does it support streaming?

Yes. Both search apps use Server-Sent Events (SSE) streaming by default — visitors see answers generated word by word as they're produced.

How does it handle follow-up questions?

The AI maintains conversation context within a session. Follow-up questions are automatically rewritten into standalone questions for better retrieval, while preserving relevant context from the conversation.

What about price and stock questions?

The AI understands budget constraints ("under $50"), stock requirements ("only show in-stock items"), and delivery questions. It automatically filters and sorts results based on these constraints, with smart fallbacks when too few products match.

Billing & Plans

How does billing work?

Each domain has its own subscription, billed monthly via Stripe. All plans include a free trial — your card is collected at registration but not charged until the trial ends.

What happens during the free trial?

You get full access to all features for the duration of your trial. Cancel at any time during the trial — there's no charge. If you cancel and re-subscribe later, any remaining trial days carry over.

What happens when I hit my question limit?

When daily or monthly limits are reached, new questions receive a rate-limited response. Your dashboard, indexed data, and all configuration remain fully accessible. You can purchase top-up packages or upgrade your plan for more capacity.

Can I use a coupon code?

Yes. Coupon codes can be applied during registration for percentage or fixed-amount discounts on your subscription.

E-Commerce

Does the search app support add-to-cart?

Yes, with the Cart search app. It supports platform-native add-to-cart for Shopify (AJAX API) and Magento (AJAX with form key). The search app cart stays in sync with your website's cart. Multi-variant products (sizes, colors) direct visitors to the product page for selection.

What conversion data is tracked?

The Cart search app tracks product views, add-to-cart events, quantity changes, checkout clicks, and order completions. Shopify stores can also set up webhook-based order tracking for more accurate attribution. All data appears in the Insights section of the dashboard, including a conversion funnel and revenue-by-search-question attribution.

Does it show stock availability?

Yes. Stock status labels (In Stock, Limited Stock, Out of Stock) are displayed on product cards. The Cart search app also performs real-time stock checks before adding items. Out-of-stock products have add-to-cart disabled automatically.

What currencies are supported?

The search app supports 36+ currencies with proper symbol display (USD, GBP, EUR, JPY, AUD, CAD, and many more). Currency is automatically detected from your e-commerce platform during product extraction.

Troubleshooting

Search returns no results

Answers seem wrong or generic

Search app not appearing on my site

Forgot my dashboard password

Click "Forgot Password?" on the login page and enter your email. You'll receive a reset link valid for 1 hour. Check your spam folder if it doesn't arrive within a few minutes.

Product data seems outdated

Previous Dashboard Guide