Complaintr Docs

Install the widget

Put Core on your website with one line, and see what your visitors get.

The widget puts Core in the corner of your website. Visitors ask questions, report a problem, read your help articles and news, and see your offers, without an account and without leaving the page. It runs in its own Shadow DOM, so your site's styles and the widget's styles never mix.

Core on your website Widget illustration
miraboutique.com
How can I help?Ask Mira Boutique anything
Ask a questionAnswered right away
Report an issueTell me what went wrong
MessagesContinue a conversation

The project name in your script tag decides which business Core answers for.

Set it up

Open in Complaintr
  1. Create a project for the website or product in Projects.
  2. In the sidebar, open Integrations, choose Website widget, then click Setup.
  3. Select the project that should receive complaints.
  4. Customize the widget, then click Save changes.
  5. On the Install tab, pick how to install it. The step opens on your site's platform when Complaintr recognizes it (Shopify, WordPress, Wix, ikas, Ticimax, and others). Under Send to my developer, enter their e-mail and click Send the steps.
  • The snippet never changes. Widget updates reach the site by themselves; see Updates on the Appearance tab.

The widget settings page has three tabs: Install, Appearance, and Content. Settings are saved per project, and the widget on your site picks them up the next time a page loads. The line on your site never needs to change.

Add the line to your site

The Install tab reads what your site is built with and opens on its steps.

  • An AI tool you build with (Claude Code, Codex, Cursor, OpenCode, Copilot, Windsurf, Lovable, v0, Bolt, Replit): pick it, follow its three steps, and paste the prompt it gives you. The prompt adds the widget and the verification tag for you.
  • A site builder (WordPress, Shopify, Wix, Webflow, Squarespace, Framer, ikas, Ticimax, Google Tag Manager): choose Site builder for its steps.
  • Someone else built the site: choose Send to my developer, enter their email, and click Send the steps. Complaintr emails them the line, the verification tag if the site is not proven yet, and a link to this page.
  • Your own code: choose Add it myself.

Add the line once, in the part every page shares:

HTML
<script src="https://app.complaintr.com/widget.js?app=Mira%20Boutique" defer></script>

Place it before the closing </body> tag on every page. For React with Vite, put it in index.html; for SvelteKit, in src/app.html.

Replace Mira%20Boutique with your project's name. The project name can also be given as data-app="Mira Boutique" on the tag.

Prove the site is yours

A project with a website opens once Complaintr knows the site is yours. Usually there is nothing to do: when the widget loads on the site, Complaintr reads the home page and confirms it. The page checks by itself every few seconds.

If the widget cannot go on the site yet, choose Verification tag or DNS under Add it myself and add either the meta tag to the home page's head or the TXT record to your domain's DNS. An account email confirmed on the site's own domain also proves it. A website can belong to only one project.

Check that it works

The Install tab shows Seen on your site once the widget has loaded on your site, and Check my site now looks for the line on the home page right away. Then open your site and try it as a customer: ask a question, and report a test problem. It arrives in the Inbox with the Web widget source.

What visitors get

Your greeting over your brand color, a box to ask Core anything, and shortcuts to Report an issue and Request a feature. It can also show your newest campaign, an announcement banner, a survey, and a 1 to 5 rating of the experience.

  • Ask: Core answers from what it knows. When the visitor describes a problem, it asks what is missing and files a complaint once they agree.
  • Report an issue and Request a feature: short forms with an optional email address. They are filed directly, without a conversation, and include the page the visitor was on.
  • Reach a person: when Core cannot help, it asks whether to pass the message on and, with a yes, how a person can reach them. See Needs follow-up.

The widget speaks in the visitor's language (English or Turkish), wears your logo and name, and ends with a small Powered by Complaintr line. On a phone it opens full screen, and the message box stays above the keyboard. The smiley next to the message box adds emoji, and Core reads them like any other text.

Attachments

In a conversation, a visitor can attach up to 4 images (PNG, JPEG, GIF, or WebP, up to 10 MB each), 1 video (MP4, MOV, or WebM, up to 50 MB), and 3 PDF files (up to 4 MB each, such as an invoice or an order confirmation) to a message with the paperclip, by pasting a screenshot into the message box, or by dropping files on the conversation, and can send them without text. Core looks at them while it writes the complaint, and the complaint keeps them for your team. A video reaches Core without its sound.

  • Where they appear: on the complaint under Attachments, in its conversation, and on the page of a complaint routed to a member of your team. Share cards never show them.
  • How long they are kept: 90 days after the upload, or less when the complaint is deleted. An upload the visitor never sent is deleted after a day.
  • Limits: a visitor can upload a few files a minute and up to 100 a day, and a project takes up to 2 GB of files a day from all its visitors together.
  • Not offered: in the setup preview, and when attachments are not available on the server.

On this page