Modifying your widget content

The instructions below are for desktops and laptops only.

You can easily change your widget content from your tawk.to dashboard. In this guide, we’ll show you how to change the language, edit header and body cards in each state (Online, Away, and Offline), and manage your Pre-Chat form for your chat widget.

Open the Widget Content editor

1. Log in to your tawk.to account, and select the correct property.

2. Click Administration in the left navigation bar.

4. Click Chat Widget in the left submenu.

5. Scroll down to Widget Content and click Edit Content.

6. On the Widget Content page, your settings appear on the left, and a live preview of your widget is on the right. Here, you can:

- Change the widget’s language
- Enable or disable features such as Live Chat, Knowledge Base, and Video + Voice + Screensharing
- Customize Online, Away, and Offline states, as well as the Pre-Chat form

Your changes take effect immediately—no need to update the widget code on your site.

7. When you’re finished customizing your widget, press Esc or click the close icon at the upper-right corner to exit the content editor. You’ll return to the Chat Widget settings page.

Change the widget language

Click the Language dropdown and choose a language for your widget’s menu, labels, buttons, and forms. Learn more about changing your widget’s language with this guide: Changing your widget language

Enable or disable channels and add-ons 

Toggle the switches to enable or disable the channels and add-ons for your widget:
- Live Chat

- Knowledge Base

- Video + Voice + Screensharing

- Calendar (coming soon)

Customize widget states: Online, Away, and Offline

You can customize the widget’s content for each state:

  • Online: Visitors can start a live chat

  • Away: Indicates that agents may not be immediately available

  • Offline: Displays a form so visitors can leave a message and contact details

Edit Header and Body Cards

The chat widget is built using cards — modular sections that organize what visitors see in your widget:

  • Header Cards appear at the top of the widget and often include your logo, heading, or agent details.

  • Body Cards appear below the header and contain main content such as chat options, Knowledge Base search, or custom text.

Here’s how to customize your cards:

  • To add a card, click + Add and choose the card type you want.

  • To edit a card, click the pencil icon beside it. Click Update to save your edits.

  • To show or hide a card, toggle the switch next to the card name.

  • To move a card up or down, click the move icon next to the card name and drag it to the position you want.


Here are the types of cards you can add to the header and body:

CardHeaderBody
AgentsYes-
LogoYes-
HeadingYesYes
Text AreaYesYes
ChatNoYes
ImageYesYes
VideoYesYes
Knowledge Base SearchYesYes
Knowledge Base Article List-Yes
Knowledge Base Featured Article-Yes
Chat History-Yes

By default, the widget includes Heading, Text Area, KB Search, Chat, and Previous Conversations cards.


See this guide to learn more about editing the Header and Body cards: Customizing the widget header and body cards


Examples:


Under Header Cards, you can adjust the Alignment and edit the Content for the Heading and Text Area.

Under Body Cards, you can enable or disable features like KB Search, Chat, and Previous Conversations.

The Pre-Chat and Offline forms

The Pre-Chat form helps you gather visitor details before a chat begins, while the Offline form allows visitors to contact you even though you’re offline. You can ask visitors for their name and email, or other information to help your team prepare before replying. 

The Pre-Chat and Offline forms use the same field types and settings. You can also connect fields to Custom Attributes to store visitor responses on the contact record.

Follow these steps to setup the Pre-Chat and Offline forms:

1. To enable and customize the Pre-Chat form, click Pre‑Chat under Widget State. Then, switch Enable Pre‑Chat on.

To customize the Offline form, click Offline under Widget State.

2. (Optional) Add a message above the form on your widget. Click + Add under Header Cards, choose Text Area, and enter your message.


3. Click + Add under Body Cards and select Form

4. This adds the Form with default fields such as Name and Email. Choose the fields you want under Add fields. You can also connect some fields to Custom Attributes to save visitors’ responses to contact records. Click Save when you’re done. Your changes are effective immediately.

For detailed steps in setting up the Pre-Chat and Offline Forms and using Custom Attributes, see these guides: 
Using the Pre-Chat Form
Using the Offline Form

Additional considerations

  • Per-property customization
    If you manage several properties or multilingual websites, remember to customize widget content separately for each property and language.

  • Pre-Chat form impact
    Requiring visitors to fill out a form before chatting may reduce chat volume. Keep the form short and only ask for essential information.

  • Best practices
    Keep messages brief and easy to read. Use clear headings and short text areas so visitors can quickly find what they need.

  • Testing
    Always preview your widget in each state (Online, Away, Offline) and check how it looks on both desktop and mobile devices.

Related guides


If you have feedback about this article, or if you need more help:

Was this article helpful?

493 out of 614 liked this article

Still need help? Message Us