Getting started
Install the plugin, see what it learns about your site and what it says.
- Activate, renew and move your licence Site Mascot 2.4.0 uses Stardetha One: one paid licence per website.
- What Site Mascot does An animated 3D mascot that learns your website, greets visitors, answers their questions and reports what they ask.
- Install and first steps Activate the plugin, check what it learned and try your first conversation.
- How it learns your site What the scanner reads, what it skips and when it runs.
- What it says on each page The automatic lines for each page type, and how to override them page by page.
Mascot Studio
Make the mascot look like any character, save several and move them between sites.
- Choose a character Pick a ready-made character and dress it in the Mascot Studio.
- Make a mascot from a picture Upload a photo or drawing and let the Studio cut it out and read its colours.
- Save, switch, export and import mascots Keep several mascots, switch between them and move one to another site.
- Use your own 3D model (.glb) Upload a .glb with named animation clips to replace the built-in character.
Chat and Q&A
How the chat decides what to say, and how to write and import your own answers.
- How the chat decides what to say The order the mascot tries: small talk, your Q&A, contact details, your pages, then AI.
- Write your own Q&A Add questions and answers one at a time, with other wordings and a link button.
- Import and export Q&A with CSV Bring a spreadsheet of questions and answers in, or take your list out.
- Turn unanswered questions into answers Find what visitors asked that the mascot could not answer and fix it in one click.
- Turn on AI answers (optional) Add your own Anthropic key for short, natural replies, with limits that keep costs predictable.
Visitor details
Ask visitors for a few details before the chat, and manage what they send.
- Turn on visitor details Make visitors fill in a short form before they can use the chat.
- Edit the visitor details form Fields, steps, conditional questions, replies per choice and the closing message.
- Submissions, CSV and privacy See what visitors entered, export it, delete it and keep it private.
Conversations and analytics
Read conversations, find unanswered questions and measure engagement.
- Read the conversation log Search, filter and export every chat, and control how long it is kept.
- The Analytics dashboard What each number on the Analytics page tells you.
Privacy and settings
Data retention, personal data, isiZulu and accessibility.
- Privacy and your visitors' data What is stored, what is masked, how long it is kept and what to put in your privacy policy.
- isiZulu and other wording Built-in isiZulu text, what to check and where to override it.
- Accessibility and reduced motion Keyboard use, screen readers and visitors who prefer less motion.
For developers
Hooks, the JavaScript API and Google Analytics 4 events.
- Hooks and the JavaScript API PHP filters and actions, plus JavaScript calls that are safe before the mascot loads.
- Google Analytics 4 events Every event the mascot sends and the parameters it carries.
Troubleshooting
Fixes for the most common problems.
- The visitor details form does not appear The most common cause is a cached page or script. Here is what to do.
- The mascot does not appear Checks for when the mascot is missing from a page or the whole site.
- AI answers are not working Why the mascot falls back to a plain page search.
- Visitors share one rate limit behind a CDN Make limits per visitor when your site sits behind a proxy.
