> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/settings/installation.md).

# Installation

Reference for Settings > Installation: the snippet, the detection status, identification and Force Identify, plus the CSP domains to allow.

**Settings > Installation** holds what a developer needs to put Jimo in your app: the snippet with your Project ID and the identification options. The walkthrough lives in Getting started; this page says what each setting does and where it is, and which domains to allow if your app has a Content Security Policy.

{% hint style="info" %}
**Installing for the first time?** Follow [Install Jimo](https://help.usejimo.com/docs/getting-started/install-jimo.md): both routes (with a coding agent, or by hand), the identify call, and the checks. This page does not repeat it.
{% endhint %}

## Settings on this screen

| Setting                   | What it does                                      | Effect on your users                                            |
| ------------------------- | ------------------------------------------------- | --------------------------------------------------------------- |
| **Snippet**               | Loads the Jimo SDK with your Project ID           | Experiences can run on every page where it loads                |
| **Force Identify**        | Jimo starts only after an identify call           | Anonymous visitors see no experience and are not counted as MAU |
| **Identify verification** | Jimo accepts only user IDs signed by your backend | Nobody can identify as someone else from the browser console    |

## The snippet

The snippet loads the Jimo SDK. It carries your Project ID and goes in the `<head>` of every page of your app where experiences should run. Same snippet on staging and production: [environments](https://help.usejimo.com/docs/settings/environments.md) decide where each experience shows.

#### Detection status

Once the snippet runs on your app, the Installation screen shows it as detected on your domain.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FNCOxlh00DBc8lapPBBuK%2Fsettings-installation.png?alt=media&amp;token=211ef2b9-5d1c-4401-b795-12237749d450" alt="Settings, Installation: the snippet block with the detection status on the project domain"><figcaption></figcaption></figure>

#### Google Tag Manager

You can load the snippet through a tag manager instead of the code. See [the GTM section](https://help.usejimo.com/docs/for-developers/for-developers/install-our-sdk#install-with-google-tag-manager) of the SDK guide.

#### Load Jimo on some pages only

With manual initialization, your app decides on which pages Jimo starts. Pages where Jimo does not initialize show no experience and do not count toward your [MAU](https://help.usejimo.com/docs/settings/mau-monthly-active-users.md). See [Manual initialization](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/manual-initialization).

## Identification

The **Identification** tab gathers the settings about who your users are.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F6eo3RtdosES0IBocGq5V%2Fsettings-installation-identification.png?alt=media&amp;token=780a414d-0cd1-4393-9f24-2c7a9302773c" alt="Settings, Installation, Identification tab with the Force Identify toggle and the Identify verification block"><figcaption></figcaption></figure>

#### Identify call

The SDK call that tells Jimo "this visitor is user 1234 of your app". Without it, every visitor is anonymous: no targeting on plan or role, and each device or cleared cache counts as a new MAU. What to ask your developer for: [Identify your users](https://help.usejimo.com/docs/getting-started/install-jimo/identify-your-users.md). The code: [Identify users SDK guide](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/identify-users).

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FAgBoyJBn1a7Zy4IPTUsq%2F08-snippet-vs-identify.png?alt=media&amp;token=2674de20-7753-4b05-bbd4-16f65ad461b0" alt="Snippet only compared with snippet plus identify"><figcaption></figcaption></figure>

#### Force Identify

When on, Jimo initializes only after an identify call, and buffers any command pushed before. No session is ever logged as anonymous, and a user starts counting toward your MAU only once the identify call has run.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FromiFhOuqQUdIk6zELmJ%2FE2-02-force-identify-mau.png?alt=media&amp;token=00a6ad8a-7472-4b1a-984d-c7ec0ecccd50" alt="Force Identify off: the page loads, the snippet initializes and the visitor counts as MAU, identified or anonymous. Force Identify on: the snippet waits for the identify call, then initializes and the user counts"><figcaption></figcaption></figure>

| Your app                                              | Force Identify                                                  |
| ----------------------------------------------------- | --------------------------------------------------------------- |
| Every user is logged in                               | On. Anonymous traffic never reaches your MAU.                   |
| Public pages or a signup page should show experiences | Off. Anonymous visitors need Jimo to start without an identify. |

With Force Identify on, a page where the identify call does not run shows nothing, the Troubleshoot tool included. That is expected, not a bug.

#### Identify verification

Optional. Your backend signs each user ID, and Jimo rejects an ID that was not signed, so nobody can identify as someone else from the browser console. See [CSP and identity verification](https://help.usejimo.com/docs/getting-started/install-jimo/csp-and-identity-verification.md).

## CSP domains

If your app sends a Content-Security-Policy header, it has to allow the domains Jimo loads from. The Installation screen does not list them: the domains to allow, directive by directive, are in [CSP and identity verification](https://help.usejimo.com/docs/getting-started/install-jimo/csp-and-identity-verification.md).

## Who uses this screen

Developers read the snippet here; product owners turn Force Identify on or off. Invite your developer with a role that can open Settings > Installation, or send them the instructions from the Get Started page. See [Roles and permissions](https://help.usejimo.com/docs/getting-started/your-workspace/roles-and-permissions.md#invite-your-developer).

## Verify

* The Installation screen shows the snippet as detected on your domain.
* In the browser console of your app, `window.jimo` is an object: `undefined` means the script is missing, `[]` means it is present but not initialized.
* Your own account appears with your name in [Users & Segments](https://help.usejimo.com/docs/analyze/users-and-segments.md), not as Anonymous.

The full list of checks is in [Install Jimo](https://help.usejimo.com/docs/getting-started/install-jimo.md#verify).

## Go further

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Install Jimo</strong></td><td>The walkthrough: coding agent or by hand, then the checks.</td><td><a href="https://help.usejimo.com/docs/getting-started/install-jimo.md">Install Jimo</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FQykEzc0i8Ni0lGkxr3d5%2FE2-c04-installation.png?alt=media&amp;token=97236518-1412-4b32-9115-d3d33b092c40">E2-c04-installation.png</a></td></tr><tr><td><strong>Identify your users</strong></td><td>What to ask your developer for, and why one person is one MAU.</td><td><a href="https://help.usejimo.com/docs/getting-started/install-jimo/identify-your-users.md">Identify your users</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FevdSJaClfTeFx4ZmdDnD%2FE2-c16-mau.png?alt=media&amp;token=456b7fdb-9532-44a4-8217-7b951fcdbb66">E2-c16-mau.png</a></td></tr><tr><td><strong>Attributes and events</strong></td><td>The data your targeting and goals rely on.</td><td><a href="https://help.usejimo.com/docs/getting-started/install-jimo/attributes-and-events.md">Attributes and events</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FWRiQx3vezp2C12ewue0R%2FE2-c07-team.png?alt=media&amp;token=114a9208-bb9b-42ec-931d-e236259d08d8">E2-c07-team.png</a></td></tr></tbody></table>

* [Install our SDK](https://help.usejimo.com/docs/for-developers/for-developers/install-our-sdk), for developers

**Next page:** [Environments](https://help.usejimo.com/docs/settings/environments.md)
