# Widget SDK

Section: Tidio Features

Description: Find the Widget SDK documentation and your project keys to customize the chat widget with JavaScript.

Verified against Tidio panel 12.331.0

Last updated: 2026-11-10

Source: https://help.tidio.com/articles/widget-sdk/

The Widget SDK is a collection of front-end scripts that can force certain behavior on the Tidio widget (the front end). You can see these commands in our documentation [here](<https://developers.tidio.com/reference/introduction>).

 

Please keep in mind that due to each website's specific design, we cannot assist with customizing the API commands or implementing them on your website. These methods will be helpful for developers only.

 



 

**In this article, you'll learn:**

 

- [How to find your project keys and documentation](<https://help.tidio.com/articles/widget-sdk/#project-data>)
- [How the Widget SDK works (and the available commands)](<https://help.tidio.com/articles/widget-sdk/#available-api>)

 



 

💡

 

If you require any assistance setting any of these functions, please contact your web developer or respective platform support.

 



 

## Finding your project keys and documentation

 

Head over to **Settings \> Developer \> Project data**. Click the **Public key** field to select its value, then copy it. Only the project owner can reveal the private key; do not paste that private key into your website.

 

The **Identify visitor** section explains how to pass visitor details to Tidio. Click **Visit widget SDK documentation** to open the developer documentation:

 ![The Project data page with the Public key field, masked private key and Visit widget SDK documentation button visible](<https://help.tidio.com/article-media/widget-sdk/21.1.png>) 

## Available API commands

 



 

To use the Widget SDK, you need to insert the Tidio chat code into your website. Below, you can see our list with the available commands that you can implement on your website.

 



 

💡

 

Please note that some of the commands require a specific placement in the page's code (e.g., before the chat script). Please refer to the command description in the docs page for where should it be used exactly.

 

Tidio's Widget SDK allows developers to:

 

- [Define visitors' data such as user ID, email, name, and phone](<https://developers.tidio.com/docs/widget-visitor-identification>)
- [Update visitors' data](<https://developers.tidio.com/docs/widget-visitor-identification#updating-visitor-data>)
- [Update contact properties after defining them in the panel](<https://developers.tidio.com/docs/widget-contact-properties>)
- [Run code after the Tidio widget has fully loaded](<https://developers.tidio.com/docs/widget-listeners-events#fully-loading-tidio-chat>)
- [Set custom automation events ](<https://developers.tidio.com/docs/widget-automation-events>)
- [Open the chat widget as if a user would click on the chat icon](<https://developers.tidio.com/docs/widget-other-methods#popup-open>)
- [Close the chat widget](<https://developers.tidio.com/docs/widget-other-methods#popup-close>)
- [Set the widget color](<https://developers.tidio.com/docs/widget-other-methods#set-chat-color>)
- [Open the chat widget by clicking a link](<https://developers.tidio.com/docs/widget-code-snipets#open-chat-widget-on-link-click>)
- [Load the chat widget with a delay](<https://developers.tidio.com/docs/widget-code-snipets#load-chat-widget-after-a-while>)
- [Open the chat widget after load](<https://developers.tidio.com/docs/widget-code-snipets#open-widget-after-load>)
- [Set the language based on HTML attribute or other variable](<https://developers.tidio.com/docs/widget-code-snipets#widget-language>)

 



 

You can find the most recent API in our [documentation](<https://developers.tidio.com/docs/widget-introduction>) and custom scripts in our [Support codepen](<https://codepen.io/TidioSupport>).

 



 

💡

 

Please remember that we are unable to assist with customizing the API commands and implementing them on your website.

 

## Further reading

 

- [Opening the Chat Widget from a custom button or a link](<https://help.tidio.com/articles/open-widget-from-button-or-link/>)
- [Opening the widget automatically](<https://help.tidio.com/articles/open-widget-automatically/>)
- [Show Tidio Widget Only on Specific Pages](<https://help.tidio.com/articles/show-widget-only-on-specific-pages/>)