Docs Dashboard Guide

Dashboard Guide

A walkthrough of every page and feature in the brng.ai admin dashboard.

On this page

Login & Authentication

Signing in

Navigate to your dashboard URL and enter your email and password. After signing in, you're redirected to the Overview page (or any page you were trying to access).

Password management

Security

Sessions are managed via secure JWT tokens. All routes are protected — unauthenticated users are automatically redirected to the login page. Optional Cloudflare Turnstile bot protection is available on login and registration forms.


Dashboard Layout

Click the sun/moon icon in the header to toggle between light and dark mode. The dashboard theme color is configurable per organization.


Domain Switching

brng.ai supports managing multiple websites (domains) from a single dashboard. Each domain has its own data, analytics, search app configuration, and settings.

The domain picker is at the bottom of the sidebar. Click it to open a dropdown of all domains in your organization. Selecting a domain updates all data-driven pages: Overview, Insights, Prompts, Stop Words, Customization, and Settings.


Overview

Your at-a-glance dashboard for the selected domain, with a sticky period filter bar (Today, 30 Days, 12 Months) that controls all data on the page.

For e-commerce domains (Cart search app enabled)

For content domains

Click any stat card to switch the chart to that metric. Each card has an info tooltip explaining the metric.

Onboarding checklist

New domains show an inline onboarding checklist on the Overview page. Each step shows its status, progress, and an action button. The checklist auto-completes when all steps are done.


Insights

The Insights page (labeled "Insights" in the sidebar) provides detailed search analytics across multiple sub-tabs:

Sub-tab Content
Search Log Full paginated log of all search questions with filters (keyword search, date range). Each row shows timestamp, question, device, products returned, follow-up count, and cart adds (if applicable).
Click Throughs Questions ranked by click-through rate.
Results Served Top questions by number of results returned.
Search Gaps Questions that returned no results or low-quality results — useful for identifying content gaps.
Conversions Revenue attribution by search question — shows which questions led to orders, with revenue and order time. (E-commerce only)
User Journey Session-based view of visitor behavior — grouped by search question with a timeline of actions (product views, cart adds, checkouts, orders). (E-commerce only)

Data can be exported as CSV or PDF using the Export button, with optional date range filtering.


Customization

The Customization page controls how your search app looks and behaves. It's organized into three sections:

Search App Active

A toggle to enable or disable the search app on your website (kill switch). When disabled, the search app is removed entirely from your site without needing to change any code.

Search App Basics

Customize Appearance


Prompts

The Prompts page provides a version-controlled editor for the AI prompts that shape your search responses. Five prompt types are managed via tabs:

Prompt Type Purpose
Intent Classification Determines whether a question is about products, website content, or both
Summary Generation Controls how the AI composes its answer from retrieved documents
System Sets overall personality, tone, and behavioral constraints
Question Rewrite Rewrites follow-up questions into standalone questions for better retrieval
Rewrite Intent Determines whether a follow-up question requires rewriting

Version control

Actions


Stop Words

Stop words are terms filtered from search questions before processing. This improves search accuracy by removing noise.

Global Stop Words

Default stop words that apply to all websites. Managed by the platform team. Common articles, prepositions, and filler words.

Website Stop Words

Extra stop words just for your website. Admins and Editors can add; Admins can delete. Use these for site-specific terms like competitor names or irrelevant product terms.

Both lists are merged before each question is processed. Add a stop word by typing it and pressing Enter. Remove by clicking the X on its tag.


Payment Plans & Billing

The Payment Plans page shows your subscription status and available plan tiers. Each domain has its own subscription.

Subscription status

A status card shows your current plan, subscription state (Trialing, Active, Payment Due, Suspended, Cancelled), trial countdown with progress bar (if applicable), and billing period.

Free trial

New domains get a free trial. Your card is collected at registration but not charged until the trial ends. Cancel during the trial at no cost. If you re-subscribe later, any remaining trial days carry over.

Plan management

Top-up packages

Need more capacity? Purchase top-up packages to add extra daily/monthly questions on top of your plan limits. Available for active subscriptions only.


Settings

Settings is organized into sub-pages accessible from the left sub-menu.

General

Organization name, domain URL, industry, timezone, date format, billing address, and Website Type toggle (E-commerce or Content — this controls which search app features and dashboard sections are available).

Product Data

Visible for e-commerce domains only.

Connect your e-commerce platform and manage product data extraction:

Website Data

Configure website content importing:

Integration

Your search app embed code, ready to copy — pre-configured for your domain. Includes a Verify Installation button that checks your live site for correct placement and CSP configuration.

Security

Session timeout configuration, API key management (generate, view prefix, regenerate), IP whitelisting, and danger zone actions (reset configuration, delete organization).

Notifications

Configure email, Slack webhook, and generic webhook notifications for search anomalies, ingestion failures, and usage thresholds. Set digest frequency and quiet hours.


Users & Roles

Manage who has access to your dashboard. The users table shows name, email, role, status (Active/Inactive), and last login.

Roles

Role Access Level
Super Admin Full access across all organizations. Platform-level settings, global prompts, plan management, partner program.
Org Admin Full access within their organization across all domains. Can manage users, domains, and organization settings.
Admin Full access within their assigned domain. Can manage users, settings, and all content.
Editor Can modify prompts, stop words, and search app customization. Cannot manage users or security.
Viewer Read-only access to analytics and configuration pages.

Inviting users

Click Add User, enter the person's name, email, and role, then click Send Invitation. They'll receive an email with a link to set their password and sign in.

Access control

Menu visibility and feature access are controlled through a 4-tier permission system: Global defaults → Organization overrides → Domain overrides → User overrides. This is managed by Super Admins from the Access Control section in Settings.

Previous Widget & API Reference