# Embedding White Swan Chat

You can embed the White Swan Chat into your own website or application. This allows clients to access live support directly within your own environment, outside of a White Swan hosted client journey.

***

#### Get Started With Embedding

To get started with embedding the White Swan chat, visit the [Business Chat Page](https://app.whiteswan.io/partner_dashboard?p=chat) via the dashboard, expand the left hand side menu and select Embed Chat in the bottom, above Settings.

You can embed the chat either as an expandable widget that is always visible, or as a standalone widget that you can put on any page.

Once you've selected your embed type, copy and paste the embedding code into your own app.

{% hint style="info" %}
Only the expandable chat is supported for use within the \<head> section of an HTML page. The standalone chat must be embedded within the body.
{% endhint %}

You also need to ensure that your domain is [white-listed for embedding](/partner-knowledge-base/embedding-white-swan/whitelisting-domains-for-embedding.md) for this to work.

***

#### Security Considerations

Users accessing embedded chat may encounter:

* Contact detail prompts if they haven’t yet identified themselves
* 2FA if visiting from new devices via a deep link

These safeguards ensure that chat history and client data remain secure.

***

#### Notifications

Once contact details are known, notifications behave the same way regardless of whether the chat is embedded or hosted on White Swan.

Embedding enables seamless support workflows today and will allow smooth adoption of AI-driven chat in future releases.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whiteswan.io/partner-knowledge-base/chat/embedding-white-swan-chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
