Skip to content
Browse documentation

Where every setting lives

The ChatFlint menu has five items, and every setting in the plugin sits in a tab inside one of them. If you know what the setting is called, type it into the search box at the top of this sidebar. If you only know roughly what you want to change, the tables below are the map.

Older guides and videos mention screens called Analytics and Behavior. Those are the Dashboard and Settings → AI Behavior now. The old Analytics URL still works and redirects.

Settings

Eight tabs. This is where everything that is not appearance lives.

TabWhat you set thereExplained in
General & AIChat provider and API key, automatic failover, chat model, embedding provider and model, re-embed the knowledge base, system prompt, show sources, RAG debug mode, knowledge-gap detectionConnect an AI provider, Choose an embedding provider
Knowledge & SyncWooCommerce sync, Supabase URL and service key, daily freshness check, scheduled re-crawl, sync to SupabaseSync your WordPress content, Crawl a website
AI BehaviorPersona and tone, answer voice, stay on topic and strictness, website guide, Business Facts, reply in the visitor’s language, reply language, cross-language search, knowledge base language, canned responses, conversation ratingsPersona and answer voice, Keep it on topic, Business facts
Leads & SupportLead capture and when to ask, form fields and text, notification email, human handoff, the “Talk to Human” button, auto-trigger conditions, response timeout, Telegram and email alerts, business hours and the offline messageCapture leads, Set up human handoff, Notifications
Privacy & DataAI disclosure and its wording, privacy contact email, generated privacy text, consent notice and text, privacy policy URL, data retention, remove all data on deleteThe privacy kit, Deletion and retention
IntegrationsWhatsApp phone number ID, access token, verify token, app secret, and the webhook URL to paste into MetaWhatsApp
Pricing & LimitsAnswer cache and its lifetime, clear the cache, maximum answer length, answer depth, rate limiting per window and per day, the global daily cap, token pricing overridesThe answer cache, Answer length, Rate limits and spam
Import / ExportDownload every setting as a file, and load one from another site. Secrets are never includedMove settings between sites

Design

Five tabs, with a live preview beside them: every change here shows in the panel before you save.

TabWhat you set thereExplained in
Theme & ColorsTheme preset, accent color, header color and fill, subtitle text, avatar or logo image, bot and visitor bubble colors, corner roundness, text sizeTheme the widget
Placement & VisibilityShow the chat widget on the site (the master switch), where to show it: all pages, only chosen pages, or URL patternsPut the chat on your site, Where and when it appears
Launcher & WindowPosition on screen, button style, shape, icon, size, mobile auto-hide and full-screen, open animation, pulse, chat window width and height, z-indexTheme the widget
WidgetsHome screen, shopping assistant, message avatars, the “Powered by” credit, quick replies, proactive teasers, attachments — each a card you switch on and then configureHome screen and teasers
Content & TextChatbot name, welcome message, and whether the greeting varies by time of dayHome screen and teasers

Knowledge

TabWhat you do thereExplained in
Add & SourcesAdd knowledge from WordPress content, a URL, a sitemap, PDF and Word files, question-and-answer pairs, or typed text — and see every source already indexedSync your WordPress content, Upload PDFs and Word files, Write Q&A pairs
EntriesEvery chunk the bot can quote, grouped by the page it came from. Read one, edit it, mark it official or background, delete itCheck what the bot learned, Official information vs background articles
ToolsDuplicate and overlap detection, clear the query cache, and the scoped knowledge base resetReset the knowledge base

Inbox

One screen for everything a person might be waiting on, with a badge in the menu when something is. Conversations and their transcripts, live handoff chats, captured leads, and erasure requests.

SectionWhat it holdsExplained in
ConversationsEvery chat, searchable, with tags and private notesThe handoff inbox
HandoffChats waiting for a human, and the live reply windowThe handoff inbox
LeadsContact details the form captured, exportable as CSVCapture leads
Data requestsErasure requests from visitors, waiting for your approvalDeletion requests and retention

Dashboard

The landing screen: the setup checklist while you are still setting up, then the numbers. Conversations, messages, ratings, the most-asked topics, how conversations ended, spend per model, and the shopping funnel if you sell.

PanelWhat it answersExplained in
Totals and daily chartHow much is it being usedDashboard and what the numbers mean
Most-asked topicsWhat do people actually wantQuestion topics and outcomes
Resolution outcomesHow did those conversations endQuestion topics and outcomes
Usage & costWhat is this costing meToken usage and cost
Conversation ratingsAre the answers any goodRatings and feedback
Shopping assistantDid the chat sell anythingThe shopping assistant

Screens without a menu item

Three screens are reached from links on the Dashboard rather than from the menu.

ScreenWhat it is forExplained in
System HealthThe first place to look when something seems wrong: keys, tables, cron, the knowledge base, the update channelSystem Health
Knowledge GapsQuestions the bot could not answer, with a button that turns one into a knowledge entryUnanswered questions
Help & DocsLinks back into this documentation from inside the admin

The ones people hunt for

These come up again and again, and none of them are where people first look.

You want to…Go to
Hide or show the chat entirelyDesign → Placement & Visibility → Show the chat widget on the site
Show it on some pages onlyDesign → Placement & Visibility → Where to show
Put it above or below another elementDesign → Launcher & Window → Z-index
Remove the “Powered by” lineDesign → Widgets → “Powered by” Credit
Tell it your phone number and opening hoursSettings → AI Behavior → Business Facts
Change how it talks about itselfSettings → AI Behavior → Persona / Tone and Answer voice
Stop it answering off-topic questionsSettings → AI Behavior → Stay on topic
Cap what it can cost you in a daySettings → Pricing & Limits → Rate Limiting & Cost Protection
Set when your team is availableSettings → Leads & Support → Business Hours
Ask visitors to consent firstSettings → Privacy & Data → Consent notice
Delete old conversations automaticallySettings → Privacy & Data → Data retention
Move this configuration to another siteSettings → Import / Export

Still stuck? Ask the assistant in the corner of this page — it has read all of this — or send us a message.

Last updated September 18, 2026