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

# Troubleshoot the Assistant

What to check when Userlane loads but the Assistant does not appear or shows no guides.

Sometimes Userlane is active in the application, through the browser extension or the snippet[^1], but the Assistant does not appear or shows no guides. The cause is then usually a content or portal setting rather than how Userlane is deployed. If only one person is affected, start with their browser, their targeting, and their sign-in. If everyone is affected, the cause is usually a setting that applies to the whole application, so start with the first checks below.

{% hint style="info" %}
**Userlane does not load at all?** If the browser extension does not activate on the page, start with [Troubleshoot the extension](https://docs.userlane.com/deployment/rollout/roll-out-the-extension/troubleshoot-the-extension.md) instead.
{% endhint %}

## Checks in order

{% stepper %}
{% step %}

#### Publish at least one language

Only public languages are shown to end users. If no language is public, the Assistant has nothing to show. See [Languages](https://docs.userlane.com/assistance/content-operations/languages.md).
{% endstep %}

{% step %}

#### Put guides in a published chapter

A guide appears in the Assistant only when it sits in a published chapter. Guides collected under **Unsorted Guides** are not part of a chapter. See [Creating guides](https://docs.userlane.com/assistance/in-app-guidance/creating-guides.md).
{% endstep %}

{% step %}

#### Check the targeting

Chapter and guide targeting both apply, so the person has to match the conditions on the chapter and on the guide. See [Targeting](https://docs.userlane.com/assistance/content-operations/targeting.md).
{% endstep %}

{% step %}

#### Turn on the guide list

In the portal, go to **Customize** > **Assistant** and confirm that **Activate Guide List** is enabled. Without it, guides are not listed in the Assistant.
{% endstep %}

{% step %}

#### Look for blocking errors in the browser console

Red console errors that mention Userlane together with "Content Security Policy" or "CORS" (cross-origin resource sharing) mean the application is blocking Userlane. Share them with your developers together with [Environment prerequisites](https://docs.userlane.com/deployment/rollout/environment-prerequisites.md).
{% endstep %}

{% step %}

#### Clear the browser cache and cookies

Old site data can keep outdated settings in place. Clear it, sign in to the portal again, and reload the application page.
{% endstep %}
{% endstepper %}

If the Assistant still does not show after these checks, [contact Userlane support](https://docs.userlane.com/support/contact-and-escalation.md) and say which checks you already tried.

## Relevant articles

{% content-ref url="/pages/FRU06enU3lsRJrh5njNu" %}
[Troubleshoot the extension](https://docs.userlane.com/deployment/rollout/roll-out-the-extension/troubleshoot-the-extension.md)
{% endcontent-ref %}

{% content-ref url="/pages/CIerDK8LXMzMPa8Zey5u" %}
[Languages](https://docs.userlane.com/assistance/content-operations/languages.md)
{% endcontent-ref %}

{% content-ref url="/pages/BkK6BtMQAoCXdpgXSBa5" %}
[Targeting](https://docs.userlane.com/assistance/content-operations/targeting.md)
{% endcontent-ref %}

{% content-ref url="/pages/SRW9iMERFNl0SSjAfJnd" %}
[Environment prerequisites](https://docs.userlane.com/deployment/rollout/environment-prerequisites.md)
{% endcontent-ref %}

## FAQ

<details>

<summary>The extension shows the option to open the Assistant when clicked, but the Assistant is not visible. What is wrong?</summary>

The extension is running, but the content is held back by a portal setting: no public language, guides outside a published chapter, targeting that excludes the person, or the guide list switched off. The checks on this page cover each of these in order.

</details>

<details>

<summary>Why does a guide not appear in the Assistant?</summary>

The most common reasons are that the guide is not in a published chapter, the person does not match the chapter or guide targeting, or no language is public. Guides under Unsorted Guides are not part of a chapter.

</details>

[^1]: The snippet is the JavaScript code that loads Userlane inside a single application, as an alternative to the browser extension.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.userlane.com/assistance/the-assistant/troubleshoot-the-assistant.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
