> 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/connections/support-email-routing.md).

# Support email routing

Configure a support link or email so the Assistant routes users to your team when it cannot answer.

Set up a support link so the Assistant directs users to your team when it cannot answer their question.

{% hint style="warning" %}
**Before you start.** The AI Assistant must be enabled for the application. You also need portal access to the **Customize** section.
{% endhint %}

## When the Assistant shows the support link

When the AI Assistant[^1] cannot find a relevant answer in the application's connected content, it shows a support link or email address as a contact action. The user follows the link or writes the email themselves. No conversation context is forwarded, so your support team receives the request without the question the user asked or any earlier conversation history.

If a support link was already set in the earlier version of the Assistant, it carries over automatically. Any manual edit you make takes priority over the carried-over value.

## Configure the support link

The support link is configured under **Customize** in the portal, on the **Help options** page. You can enter a URL to a help desk or ticketing system, or a `mailto:` email address.

{% stepper %}
{% step %}

#### Open Help options

Go to **Customize** in the left sidebar, then open **Help options**.
{% endstep %}

{% step %}

#### Enter your support link

Under **Show a link to your application's support**, enter the full URL or email address. The placeholder shows the accepted formats: a URL such as `examplelink.com` or an email address such as `mailto:xy@example.com`.
{% endstep %}

{% step %}

#### Enable the display toggle

Turn on **Display Support Link**. The Help section in the Assistant becomes visible to users once at least one link (documentation or support) is enabled.
{% endstep %}

{% step %}

#### Customize the link text (optional)

To change the default label shown to users, select **Customize the text** in the info block below the support link field. This opens the text editor for the Assistant's Help section, where you can edit the link label.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Result.** When the Assistant cannot find a relevant answer, it shows the support link as a contact action. Users can reach your team directly from the conversation. The Help section also appears when a user exits a guide that did not complete successfully.
{% endhint %}

## Customize the Help image (optional)

You can replace the default image shown in the Help section with a branded image. On the **Help options** page, select **Go to design** at the bottom to open the image upload. Userlane accepts PNG, JPEG, or GIF files up to 8 MB. The recommended size is 652 x 320 pixels.

## Relevant articles

{% content-ref url="/pages/jaGpQWjETS3dwv2yneLk" %}
[Configure the AI Assistant](/assistance/the-assistant/configure-the-ai-assistant.md)
{% endcontent-ref %}

{% content-ref url="/pages/XDGntxUJimFOtJOihyow" %}
[The Assistant](/assistance/the-assistant.md)
{% endcontent-ref %}

{% content-ref url="/pages/x0VOtqZaqLMPxH6L3eGw" %}
[Contact and escalation](/support/contact-and-escalation.md)
{% endcontent-ref %}

## FAQ

<details>

<summary>Does the Assistant send the conversation to my support team?</summary>

No. The user sees a link or email address and follows it themselves. No conversation transcript or question text is forwarded to the support recipient.

</details>

<details>

<summary>When does the Assistant show the support link?</summary>

When the Assistant determines it cannot find a relevant answer in the application's connected content. This happens automatically; there is no setting to control the trigger.

</details>

<details>

<summary>Can I set different support links for different audiences?</summary>

No. The support link is set per application, not per audience.

</details>

<details>

<summary>What if I already had a support link in the earlier version of the Assistant?</summary>

It carries over automatically. If you edit the link manually, your edit takes priority over the carried-over value.

</details>

<details>

<summary>Can I also add a documentation link?</summary>

Yes. The **Help options** page has a separate section for a documentation link with its own URL field and display toggle. You can enable one or both links.

</details>

[^1]: The AI Assistant is the conversational feature inside the Userlane Assistant panel that answers questions from published and connected content, and hands off to guides or support.


---

# 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/connections/support-email-routing.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.
