Setup Grimm

Setting up Grimm

Grimm is your site's AI interface — visitors browse what you offer, ask, and act, all from your content. Here's how to feed it, put it on your site, and set what visitors can do.

What it does, quickly

Grimm only uses the pages and documents you index. If the answer isn't in your content, it says so and points the visitor to you — it never makes things up. Beyond answering, visitors can browse what you offer and take action — contact you, ask about an item, or place an order — right in the widget. Each visitor message costs 1 credit from your balance; browsing and taking action are free.

Index your site

In the editor, open Knowledge and add your pages one by one — the ones that actually answer visitor questions: pricing, FAQ, opening hours, services. Each indexed page is billed once (see /pricing) and can be re-crawled anytime to refresh it.

If you've set allowed domains, you can only crawl pages from those domains.

Upload a document

No page to point at? Write your knowledge directly in the Knowledge tab (a guided text box), or upload a file — .md, .txt, .pdf or .docx. A menu, an FAQ, internal notes. Minimum 100 characters. Saving or re-uploading the same name replaces the previous version. The first document of each Grimm is free.

The simplest path to a great memory: one well-structured Markdown file that explains everything — who you are, what you offer, prices, hours, policies, FAQs, contact. A single clear document Grimm reads end to end beats a dozen scattered pages — and it is your free first document. Keep editing it as things change (saving is always free).

Connect a product feed (shops)

Running a shop? Instead of indexing each product by hand, connect a product feed (Google Merchant XML/RSS or CSV) in the Knowledge tab — Grimm builds its browse catalogue from your real stock and prices, and hides out-of-stock items.

Embed the widget

First add the domain where Grimm will live in the Deploy tab — it's required, and it stops anyone else from reusing your snippet on your balance. Then copy the script from the Deploy tab and paste it right before the closing </body> tag — WordPress or any site, no plugin:

<script src="https://grimmchat.com/widget.js" data-chatbot-id="YOUR_CHATBOT_ID"></script>

Position, theme, language and launcher shape are set in the Deploy tab and baked into the snippet you copy — there are no attributes to hand-edit. Use the Test button in the editor’s toolbar to preview it before publishing.

Add it to your site

Step-by-step guides for WordPress and for adding the code yourself:

On any other platform, paste the snippet before </body> — it works the same way.

Balance and credits

Grimm spends from your balance in Balance — it can never go over it, nor over the optional daily caps you set there. When the balance runs out, the widget tells your visitors the chat is temporarily unavailable; recharge and the chat resumes right away.

Common errors

  • "Not enough credits" — recharge in Balance, then retry.
  • "Domain not allowed" — add the site's domain in the Deploy tab. At least one domain is required before you can embed Grimm.
  • "Too many requests" — indexing is limited to a few pages per minute; wait a minute and retry.
  • The widget doesn't show up — check the script is before </body> and the chatbot id is correct.

Go further

  • Grimm's memory — how its memory works, the free starter document, and how to update or delete what it knows.
A note on data: conversations are stored per visitor session so the chatbot can keep context, and every debit is visible in your balance activity. Only index content you're comfortable making public — everything you index can be surfaced in an answer.