# Install guides

> Where the tag goes on your platform. Pick the tool your site is built with, or use the plain HTML steps that work on any website.

This page helps you find the steps for the tool your site is built with, and shows the plain version that works on any website. When you are done, your site sends its visits to Clear Saga.

## Pick your platform

Each name below opens the steps for that platform.

**[Any website](/docs/install)**

- [Other / plain HTML](/docs/install#html)

**[Frameworks](/docs/install/frameworks)**

- [Next.js](/docs/install/frameworks#nextjs)
- [React Router](/docs/install/frameworks#react-router)
- [TanStack Start](/docs/install/frameworks#tanstack)
- [Astro](/docs/install/frameworks#astro)
- [Vue](/docs/install/frameworks#vue)
- [Nuxt](/docs/install/frameworks#nuxt)
- [Laravel](/docs/install/frameworks#laravel)
- [Django](/docs/install/frameworks#django)

**[CMS and site builders](/docs/install/site-builders)**

- [WordPress](/docs/install/site-builders#wordpress)
- [Webflow](/docs/install/site-builders#webflow)
- [Framer](/docs/install/site-builders#framer)
- [Ghost](/docs/install/site-builders#ghost)
- [Shopify](/docs/install/site-builders#shopify)
- [WooCommerce](/docs/install/site-builders#woocommerce)

**[No-code and hosted](/docs/install/hosted)**

- [Bubble](/docs/install/hosted#bubble)
- [Podia](/docs/install/hosted#podia)
- [Kajabi](/docs/install/hosted#kajabi)
- [Wix](/docs/install/hosted#wix)
- [Squarespace](/docs/install/hosted#squarespace)
- [Lovable](/docs/install/hosted#lovable)
- [Bolt](/docs/install/hosted#bolt)
- [Vercel v0](/docs/install/hosted#v0)
- [Replit](/docs/install/hosted#replit)

**[Tag managers](/docs/install/tag-managers)**

- [Google Tag Manager](/docs/install/tag-managers#gtm)

Is your platform missing from the list? Use the plain HTML steps below. Any tool that lets you add code to the `<head>` of your pages can run the tag.

## Other / plain HTML

1. Paste the tag inside \<head\> on every page, or in the template all your pages share.
2. Publish, then open your site. The first visit shows up here within a few seconds.

**index.html**

```html
<script
  defer
  data-site-key="YOUR_SITE_KEY"
  src="https://clearsaga.com/js/script.js"
></script>
```

> [!NOTE]
> Use the same tag on every subdomain you want counted as part of this site.

## The same on every platform

Whatever your site is built with, the installation is one tag. These things hold for all of them:

- **There is nothing else to install.** No plugin, no app and no package exists for any platform, and none is needed. The steps only differ in where the tag is pasted and how it is written.
- **The key is the only part that is yours.** Most samples show the placeholder `YOUR_SITE_KEY`. A few read the key from a setting of the platform instead, and say so in their steps. Settings, Installation in the dashboard has a platform picker that prints the same code for your site, with your key filled in or shown next to it, so copying from there is the safest way.
- **It belongs in a shared place.** Put the tag in the template, layout or settings field that every page uses, so no page is forgotten.
- **Once per page.** When the same key is on a page twice, the second tag does nothing. If you move the tag from one place to another, remove the old one.
- **No extra code for page changes.** On a site that moves between pages without a full reload, the script notices the new address and counts the page.
- **Publish, then look.** A tag that is saved but never published sends nothing. After publishing, open your site in a normal browser window. Settings, Installation shows "Receiving data" once the first visit is in.

To see what the tag sends and which of the two scripts it loads, read [Add the tracker](/docs/tracker). If no visit shows up after you publish, [troubleshooting](/docs/troubleshooting) lists what to check.

**Next:** [Frameworks](/docs/install/frameworks), [CMS and site builders](/docs/install/site-builders), [No-code and hosted](/docs/install/hosted)
