Highlight

Control the style of absolutely anything with CSS overrides

You can now style absolutely any aspect of your TalkJS UI, using the global CSS overrides tab in your theme editor. 

Global CSS overrides complement the ability to edit and style chat components. A vast number of parts of the TalkJS UI are currently exposed as components that you can edit directly in your theme editor. However, if that’s not enough, the global CSS overrides tab gives you full control to customize your chat UI. 

For example, with a global CSS overrides you can customize the background of a chat panel however you like, such as by setting an image as the background:

.Panel {
   background-image:url('https://example.com/image.jpg');
   background-size:cover;
}

With the following result:

Chat UI with an image set as the background of a chat panel

Using global CSS overrides, you could for instance also hide the day marker that separates messages sent on different days, by setting DayMarker to display: none:

.DayMarker {
   display: none;
}

The difference between showing and hiding the day marker would be as follows:

Chat UI with and without a day marker 

You can find the global CSS override tab in the Themes section of your dashboard when editing a theme.

Global CSS override the the theme editor of the dashboard

Any CSS styles added to the global CSS overrides section of the theme editor get applied globally, to all parts of the TalkJS UI. To add a style only to a specific component, update that component directly in your theme editor.

For more information, see: Global CSS overrides.

Overview of other changes

Added

• Added support for rich text shortcodes in the message editor. Ctrl-B (on Windows) or Cmd-B (on MacOS) now adds markup for bold text, while Ctrl-I or Cmd-I adds markup for italics.
• React SDK (version 0.1.7): Added a show prop to Popup, that allows you to specify whether the pop-up widget pre-built chat UI should be shown or hidden.
• React Native SDK (version 0.8.0): Added support for push notifications via Firebase on iOS. Note: For push notifications to iOS on Expo, we currently only support using Firebase, not APNs.
• React Native SDK (version 0.8.0): Added onMessage and onUnreadsChange props to the Session component.
• React Native SDK (version 0.8.0): Added hasValidCredentials, clearPushRegistration, setPushRegistation and unsetPushRegistration methods to the Session component.
• Flutter SDK (version 0.10.0): Added support for Firebase push notifications on iOS.
• Flutter SDK (version 0.10.0): Added compound predicates to Chatbox and ConversationList.
• Flutter SDK (version 0.10.0): Added a missing themeOptions property in ConversationList.

Changed

• React Native SDK (version 0.8.0) Removed an implicit push notification permissions request. Users of this library must explicitly request for push notification permissions on iOS and Android 13+.
• React Native SDK (version 0.8.0): Removed bounce in iOS when the UI reached the edge of the content.
• React Native SDK (version 0.8.0): Renamed the AndroidChannel interface to AndroidSettings, and the IOSPermissions interface to IOSSettings.
• React Native SDK (version 0.8.1): The ConversationList no longer highlights the first conversation by default.

Fixed

• Fixed an issue where a group chat with only guests wouldn’t show usernames alongside messages in the default preset themes.
• Fixed an issue where external links would open inside an app even when Cordova InAppBrowser is used.
• Flutter SDK (version 0.10.0): Fixed a push notification error when a sender's photoUrl is invalid.
• Flutter SDK (version 0.10.0): Fixed a build issue on Android Gradle Plugin (AGP) 8.0+.
• React Native SDK (version 0.8.0): Fixed bug in Session when user synchronization is disabled.
• React Native SDK (version 0.8.0): Fixed bug with MessageField.setText and MessageField.typeText that would cause a crash when given certain strings.
• React Native SDK (version 0.8.0): Fixed bug where, under certain conditions, the HTMLPanel wouldn’t load.

New guides and tutorials 

• How to set up the Inbox UI mode as a pop-up
• How to create a poll in TalkJS
• Integrate chat into your Bildr webapp with TalkJS
• Integrate chat into a Webflow site with TalkJS

👋 Thoughts? Questions? Get in touch.

✨Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻We’re hiring! Check out our jobs page.

Highlights

Customizable link previews

You control how TalkJS displays link previews for URLs shared in the chat. For example, you can choose to remove previews for links that contain certain blocked words. And you can now also set whether you prefer your link previews to show up large or compact. 

By default, TalkJS generates a full, large preview for any link that a user shares. However, you can also set your link previews to be more compact.

A large link preview (on the left) and a compact link preview (on the right)

If you’d like your link previews to be more compact, then you can do so by setting the compact parameter of the LinkPreview or LinkPreviews components to true.

Read more on link previews.

Effortless mentions

Mentioning someone in a chat just became more effortless. Users no longer need to manually select, or hit enter or tab to mention another user in a conversation. They can simply type @name and once the user’s name is typed out in full, the chat auto-accepts the first remaining suggested mention. 

A user is mentioned in a conversation simply by writing an @ symbol and fully typing their name

For names that include diacritics, the user can even type the letters without diacritics, and the mention still matches.

Overview of other changes

Added

• Added support for sending mobile push notifications using Firebase on iOS.
• Added customizable unsubscribe links to email notifications, to allow users to unsubscribe from email notifications. You can edit the link text. If you’re on the Growth or Enterprise plan, then you can also edit the style and placement of the unsubscribe links in your email theme. 
• React SDK (version 0.1.6): Added an asGuest prop to Chatbox, Inbox and Popup, to enable users to join a conversation as a guest.

Changed

• Changed the behavior of custom message filters and custom conversation filters. You can now also filter messages and conversations for either one custom property or another, rather than only for a combination of custom properties.
• Changed the options for selecting an emoji reaction. If there is enough space for it, selecting an emoji reaction now first shows the emoji reaction favorites bar.

Fixed

• Improved stability and performance for large chats.
  
• Fixed a bug where selecting a conversation in which the user had a draft message would crash the chat.
• Fixed an issue where SMS notifications would not get sent for identical messages sent to the same person within a two-minute timeframe.
• Fixed an issue where push notifications were not sent for large payloads.
• Fixed an issue where ActionButton params wouldn’t update when switching between conversations.
• Fixed in issue where no SVG group chat images were generated for group chats.
• Fixed a bug where, under certain conditions, the message action menu would continue to stay visible even when it wasn’t interacted with.
• REST API (version 2024-01-01): Fixed a bug related to fetching conversations for a non-existing user. Fetching a conversation for a non-existent user now returns a HTTP 404 Not found status, instead of an HTTP 200 OK status.

New guides 

• How to add a hidden user to a TalkJS conversation 
• How to add a ‘Create new chat’ button in TalkJS 

👋 Thoughts? Questions? Get in touch.

✨Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻We’re hiring! Check out our jobs page.

Highlights

Customizable theme components

The theme editor in your TalkJS dashboard lets you tailor the look and feel of the TalkJS user interface to match your brand style. You can edit the default theme directly, or create your own theme from scratch. 

Each theme comes with a large number of customizable theme components. This includes top-level components such as the chat header at the top of a chat, the user message, and the message field in which users can type messages, or send attachments and voice recordings. It also includes subcomponents that are rendered by a top level component in a theme, such as the user’s avatar and the typing indicator that shows when a user is typing.

Examples of customizable theme components

We’re continuously expanding the range of components that you can customize. Additional UI components will be available to edit soon. 

Read more on customizable theme components.

Powerful feed filters

If you’re using the Inbox pre-built chat UI, you can customize which conversations show up in the conversation list of the user's inbox by using conversation list filters. 

A conversation list with only conversations related to job applications

For example, you can set up a filter to show only conversations with unread messages, conversations that were created or updated within a specific time frame, or only conversations that match a specific string. On top of that, you can filter on specific custom properties, or combine multiple filters all at once.  

You can either use the JavaScript Chat SDK or the REST API to filter conversation lists and select which conversations you return.

Read more on conversation feed filters.

Overview of other changes

Changed

• React SDK (version 0.1.5): Changed to output ES2015.

Fixed

• Fixed a bug in the team_chat preset theme which caused the MessageField layout to display incorrectly.
• Fixed a bug where autoscroll would behave incorrectly under certain conditions.
• Fixed an issue where, on iOS, replying to a message would focus the MessageField but not resize the MessageList, with the result that the keyboard would cover both the MessageField and the ReplyBar.
• Fixed an issue where, when replying to a message that contains a list, the body of the quoted message would be rendered incorrectly.
• Fixed an issue where the message action menu button would stay visible when moving the mouse fast.
• React Native SDK (version 0.7.1): Fixed a regression that would occur when selecting a conversation while onSelectConversation isn’t given. In this scenario, selecting a conversation will now show the TalkJS Inbox Mobile view.
• React Native SDK (version 0.7.1): Fixed a bug where notifications not sent by TalkJS would be displayed twice.

New guides and tutorials 

• How to integrate a chatbot into your TalkJS chat with the OpenAI API
• How to add a custom typing indicator for a chatbot

👋 Thoughts? Questions? Get in touch.

✨Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻We’re hiring! Check out our jobs page.

Highlights

Intuitive new dashboard

Your TalkJS dashboard has just become more intuitive to use, to get you started seamlessly. 

From the dashboard, you can:

• Analyze chat usage and monitor conversation details on the Activity page.
• Update the chat UI and user permissions from the Chat UI page.
• Update browser, email, and SMS notification settings from the Notifications page.
• Create and edit custom UI themes or email themes from the Themes page.
• Finetune your app-wide settings—including security settings, localization, push notifications, and webhooks—on the Settings page.
• Get real-time insights from the Live log page.

You can now find the Roles page to create or edit user roles by clicking on ‘Edit roles’ at the top of either the Chat UI page or the Notifications page.

Better push notification support

Sending mobile push notifications with TalkJS just got easier, with support for Apple Push Notification Service (APNs) tokens and the new Firebase Cloud Messaging (FCM) API.

Support for APNs tokens

TalkJS now supports using stateless authentication tokens for your communication with Apple Push Notification Service (APNs). Establishing a token-based connection to APNs has several main advantages:

• You can use the same token from multiple provider servers.
• You can use one token to distribute notifications for all apps in your Apple Developer Team.
• APNs tokens don’t expire, so once you have configured them you’re all set.

You can configure APNs tokens from the Settings page of your TalkJS dashboard.

Support for new Firebase Cloud Messaging API

TalkJS now supports the newer Firebase Cloud Messaging (FCM) API for sending mobile push notifications. 

Google has deprecated FCM legacy APIs. For push notifications to continue to work, you will need to generate and provide a service account private key at the earliest opportunity, and before 20 June 2024. 

To start using the new FCM API, take the steps in the following guide: Configure Firebase Cloud Messaging.

Overview of other changes

Added

• Added a /batch endpoint to the REST API, which you can use to perform multiple operations at once with a single call. See: REST API Batch endpoint documentation.
• Added an option to the theme editor to allow you to customize the height of the conversation list. You can find the theme editor on the Themes page of your dashboard.
• Added the option to access the current conversation object inside the MessageField theme component in the theme editor.
• React SDK (version 0.1.4): Added a useUnreads hook that returns conversations with unread messages, to make it easier to render a component based on the list of conversations with unread messages.
• React Native SDK (version 0.7.0): Added onLeaveConversation, onCustomMessageAction, and onCustomConversationAction props. These props replace the methods with the same names, which have been deprecated.

Changed

• Javascript SDK (version 0.18.0): Changed that calling .select on a UI now returns a promise that is resolved when a new conversation is selected.

Deprecated

• Deprecated the use of Apple Push Notification Service (APNs) certificates. Your configured APNs certificates will continue to work until the certificate expires. Instead of APNs certificates, you can now use APNs tokens.
• Deprecated legacy themes with limited CSS support. To change the look and feel of TalkJS to match your style, use custom themes instead.
• Javascript SDK (version 0.18.0): Deprecated ConversationSelectedEvent.others and SelectConversationEvent.others. Instead, use ConversationSelectedEvent.participants and SelectConversationEvent.participants.
• React Native SDK (version 0.7.0): Deprecated the off method in both Chatbox and ConversationList.
• React Native SDK (version 0.7.0): Deprecated onLeaveConversation, onCustomMessageAction and onCustomConversationAction methods. Instead, use the added props with the same names.

Fixed

• Fixed an issue where the push notification tester in the TalkJS dashboard would not send out test push notifications correctly.
• Fixed a bug that would make the chat freeze when attaching multiple files at once.
• Fixed an issue where email changes on the Account settings page of the dashboard did not get updated correctly.
• Fixed a bug where, on iOS, Arabic characters would not get deleted properly when using the backspace key.
• Fixed an issue where a race condition occurred when selecting the inbox and setting the text of a message field at the same time.
• React Native SDK (version 0.7.0): Fixed a bug on iOS where videos in link previews would automatically play in full screen mode, instead of inline.

Fresh tutorials and guides

• How to add chat to a Laravel app with TalkJS
• How to use TalkJS to create a team chat with channels
• Chat moderation essentials
• How to add a GIF picker to your TalkJS chat

👋 Thoughts? Questions? Get in touch.

✨Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻We’re hiring! Check out our jobs page.

Highlight

Action buttons and action links in the conversation list

You can now use action buttons and action links inside the ConversationListHeader and ConversationListItem theme components in the Inbox UI, giving you yet more control in customizing your chat. 

For example, you could add a custom action button to your ConversationListHeader to allow users easily to create a new chat, or add a custom action link to a ConversationListItem with relevant information for each conversation in the list.

A ConversationListHeader with a custom action button and a ConversationListItem with a custom action link

Read more on action buttons and action links.

Overview of other changes

Changed

• Changed the number of patches that you can send in a single call to the batch user update endpoint of the REST API to a maximum of 100 patches at a time.

Fixed

• Fixed an issue where deleting a message with an attachment did not properly delete the associated file on Cloud Storage for Firebase.
• Fixed an issue with uploading attachments when replying to a conversation via email.
• Fixed an issue in the Flutter SDK where links in Android would open in the user’s external browser by default, instead of in the WebView.
• Fixed a bug where Conversation.otherIds would return the current user (me) if that user was the only person in the conversation.
• Fixed bug that caused CustomMessageAction events to have message.id set to null for newly sent messages.

👋 Thoughts? Questions? Get in touch.

✨Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻We’re hiring! Check out our jobs page.

Highlights

Filter by creation time

Need to get all of a user’s messages sent last week? You can now filter both conversations and messages by their creation date.

Using the createdAt predicate, you can select exactly those messages or conversations that were created within a particular time interval.

Read more on filtering by creation time for messages, and for conversations.

Edit app metadata from your dashboard

You can now edit metadata for your application directly from your dashboard. 

With the app metadata editor, you can easily store and edit custom metadata for your app, for example the app’s name, or a custom website URL. Once stored, you can make these app metadata variables available in other places throughout your app, such as in roles, themes, or in your email notification templates.

Edit your app’s metadata directly from your dashboard

You can find the metadata editor under the Settings tab of your TalkJS dashboard, and access your custom app metadata in roles, themes, and notification settings with {{app.custom.<fieldName>}}. 

Multi-line inputs are supported.

Read more on using app custom fields.

Flutter SDK v0.9.1

The Flutter SDK just got better. With the release of version 0.9.1, you can use the Flutter SDK to pass data to themes, and to automatically sync the keyboard color of the chat interface based on your app's theme. 

The Flutter SDK now also has support for custom conversation actions, and ensures that various properties and methods are available for a Session object, including methods for setting, unsetting, and clearing push registrations, and for tracking the number of unread conversations in a session.

Get started with the Flutter SDK.

Overview of other changes

Added

• Added participant access right information (that is, whether a participant has read-only or read-and-write access) in a conversation to that conversation’s ConversationData in the JavaScript SDK.
• Added the option to define custom message actions that are available only for messages from other conversation participants.

Changed

• Simplified adding emoji reactions to themes. You can now pass the Reaction object as a whole to the EmojiReactionButton subcomponent in themes.

Deprecated

• Deprecated InboxOptions.selected. Instead, use Inbox.select from the JavaScript SDK.

Fixed

• Fixed an issue where the REST API batch user update did not handle invalid input data correctly.
• Fixed an issue where having multiple tabs open for a conversation would send multiple browser notifications.
• Fixed a bug where, when using the Flutter SDK, messages would only get marked as 'read' after clicking the message field, rather than when loading the chatbox.
• Fixed a bug where a custom sub-component with the same name as a top-level component would get treated as a top-level component, and hence would not be deletable.
• Fixed an issue where a failed authentication was unable to distinguish between failure due to connection issues, and an expired authentication token.

👋 Thoughts? Questions? Get in touch.

✨ Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻 We’re hiring! Check out our jobs page.

Highlights

React SDK

Are you using React for your project? Then life has just become a lot easier, with an official React SDK for TalkJS. With React components for TalkJS, you can have all the goodness of the TalkJS pre-built chat UIs inside your React web application in no time. 

TypeScript bindings are included.

Install the @talkjs/react npm package and get started.

Mark conversation as unread

Users can now mark conversations as unread. When a user marks a conversation as unread, a small dot appears inside the conversation header in their inbox to indicate the unread status. When the user switches focus back to the conversation, the unread message marker disappears.

Menu option to mark a conversation as unread

In new themes, the Mark conversation as unread feature is automatically active. For existing themes, you can follow the upgrade guide to enable marking conversations as unread.

Batch update users

Do you need to update details for multiple users? Forget making one API call after the other. You can now batch update the properties of many users at once, using the REST API. Simply send a PUT request with user objects with updated details to the /users endpoint.

Read more on how to batch update users.

Action buttons

Action buttons and action links are an easy way to let users perform quick-response actions. You can now execute custom code in your chat to create action buttons and action links.

Action buttons for color selection

You can add action buttons and links to your components in the theme editor, or apply special formatting to your messages directly. 

For security reasons, adding action buttons and action links to messages only works with messages sent via the REST API.

Read more on action buttons and action links.

Overview of other changes

Added

• Added options for customizing various components of the message field area of a conversation. This includes customizable components for the reply bar, voice recorder, audio player, emoji suggest bar, and the mention suggest list.
• Enabled message actions (such as deleting, favoriting, or reporting a message) also for users who only have read access to a conversation.
• Added a thumbnail element to themes that support a src attribute, which can be used to display image, audio, or video files that are not message attachments.

Changed

• Improved message visibility by scrolling the message field into view when it gets focused.
• Improved image previews by using the image dimensions for images that have not yet been loaded, while they are loading.
• Improved the color contrast for @mentions in the Default Dark theme.

Fixed

• Fixed an issue where the iframe background would show up light, even when the color scheme in the host webpage was set to dark.
• Fixed an issue where an audio recording playback was not properly loaded on Safari.
• Fixed a bug where focusing the message field would cause the host webpage to scroll down in Chrome and Firefox.
• Fixed a bug where email notifications for messages containing mentions would fail to send when using a templated email theme.
• Fixed several bugs where, when editing a message, the message field was not displayed correctly or the message list would have incorrect padding.
• Fixed an issue where, in the Default Dark theme, search result highlighting would make the found text unreadable.

Security

• Addressed a potential cross-site scripting (XSS) vulnerability related to uploading SVG files. When clicking on an SVG file, a user will now download the file, rather than open it directly in the browser.

👋 Thoughts? Questions? Get in touch.

✨ Follow TalkJS on 𝕏 and LinkedIn to stay up to date.

👩🏾‍💻 We’re hiring! Check out our jobs page.

Highlights

Edit participant data directly from your dashboard

You can now edit the data of any participant in a conversation directly from your TalkJS dashboard. 

To edit a participant’s data, go to the Activity section of the dashboard. From the Conversation history section of the activity landing page, select a conversation that contains the participant whose details you would like to edit. A page with conversation details will open. Click on the name of the participant whose details you would like to edit to open their User details page.

User details page with the option to edit a conversation participant’s data

You can edit any participant detail apart from the ID, which acts as a stable, unique identifier of the participant.

Image previews resize to fit aspect ratio

Image or video files now have improved thumbnail previews. Instead of cropping an image to fit, the preview thumbnail will resize to match the aspect ratio of the message attachment you sent. 

Image previews automatically resize to fit the aspect ratio of the file you sent

If you have previously edited the MessageBody component in your theme, you can follow the upgrade guide to add full support for improved attachment thumbnails.

Overview of other changes

Added

• Added bulleted list formatting to messages. You can now type *, + or - at the start of a new line, and your unordered list will automatically be formatted with bullet points in the sent message.
• Added an unread message counter to the Default Dark theme.
• Added support for playing MPEG transport stream (MPEG-TS) audio or video files (.ts, .tsv, .tsa, or .m2t). When you upload an MPEG-TS file, a preview with player options will automatically appear.

Changed

• Made various improvements to exporting a conversation transcript: the transcript export progress is calculated more accurately; download links have improved; the sender ID will be added to the transcript export; a date string will be used in the exported file name.

Fixed

• Fixed a bug where users who had been removed from a conversation were still able to reply to that conversation via email.
• Fixed a bug in the JS SDK where a rapid sequence of creating and destroying a chatbox would crash the chat.
• Fixed an error where, on the Activity view of the dashboard, it was not possible to delete a conversation.
• Fixed a bug where, on the Activity view of the dashboard, the participants dropdown would disappear after opening.
• Fixed an issue where the chat would crash when changing between chats while replying to a message.
• Fixed an issue where @mentions would break when they contained markup.
• Fixed an issue in the accuracy of the unread message counter.
• Fixed an issue where conversation participants with read permissions were not able to mark a conversation as read.  

Deprecated

• Deprecated syncThemeForLocalDev in the JS SDK. Instead of using this method, you can use custom themes, which give you full control over the HTML and CSS of chat messages.

This changelog entry reflects changes to TalkJS introduced between 12 June 2023 and 15 July 2023.

Highlights

Unread message counter in REST API and Javascript SDK

You now have two new fields available in the user's conversations REST API endpoint that will provide further insight into a user's unread messages. The unreadMessageCount field in the Conversation object will allow you to retrieve the number of unread messages a user has in a conversation. This will help in tailoring badges for the user interface.

Further, the isUnread property indicates whether the conversation has been read by the user or not. isUnread offers a convenient way to determine the read status of the conversation.

Check out the updated REST API documentation for more information and usage examples.

The unreadMessageCount property is also available in the Javascript SDK.

Export conversation data from dashboard

Exporting conversation data doesn’t need to be a hassle. You can now export conversation data from your dashboard with just a click. 

To export conversation data, go to the Activity view on the dashboard. Select a conversation, and then click Export Conversation Data. You can save a transcript as a text file, or export all the relevant data as a JSON object.

The dashboard button to export conversation data as .txt or .json files

Overview of other changes

Added

• Added several methods to Chatbox in the React Native SDK: getCurrentConversation, to retrieve the conversation currently shown in the UI; onCustomConversationAction, which triggers when a user launches a custom action on a conversation within the TalkJS UI; onLeaveConversation, which triggers when the user clicks the Leave conversation action; and sendLocation, which sends the user's current location to the currently active conversation.
• Added the isForegroundEvent property to NotificationPressedEvent in the React Native SDK, which indicates whether the user pressed the notification while the app was in the foreground or not.
• Added a leave method to ConversationBuilder in the React Native SDK, which removes the current user from the conversation.
• Added support for passing data to themes in both the Chatbox and the ConversationList layouts in the React Native SDK.
• Added Catalan (ca) to the list of languages available for localization of the TalkJS interface. A massive thank you and credit to Relab Studio for providing the translation.

Fixed

• Fixed an issue that prevented Firebase Dynamic Links from generating link previews.
• Fixed an issue which disabled zooming in when clicking the MessageField on iOS for the React Native SDK.
• Fixed a bug that prevented handling notifications in the background on Android for the React Native SDK.
• Fixed a bug where the app would not open when a notification was clicked on Android for the React Native SDK.
• Fixed a bug where dismissed notifications were not being removed from the internal list of active notifications on Android for the React Native SDK.
• Fixed an issue in the theme editor where navigation links in test mode would link to live mode, instead of to test mode.

Changed

• Made the WebView transparent in the React Native SDK. With a transparent WebView, the background color you have applied to the parent View will be used in the empty areas around the TalkJS UI.
• Changed the type of the conversation property in SelectConversationEvent from ConversationBuilder to ConversationData in the React Native SDK.
• Upgraded dependencies for the React Native SDK.
• Improved various UX aspects of the dashboard’s themes page, including improvements to the layout and dropdown menus, as well as adding the options to delete custom files, hide built-in (non-top-level) files, and reset a file to the preset version.

We've now added support for unread message counts! These appear next to each conversation's subject in the inbox, replacing the previous blue dot indicator for unread messages:

For more information on the counter and how to enable it in existing themes, see our docs on Adding new features to existing themes.

New preset themes

The new team_chat preset theme

There are now three new preset themes to go with our existing default and group_chat themes:

- team_chat: see this in action in our Team Chat demo

- default_dark: see our Marketplace demo

- livestream: see our Livestream demo

Passing data directly to a theme

The TalkJS JavaScript SDK now lets you pass data to your theme when you create a widget:

session.createChatBox({
  theme: {
    custom: {
      productTitle: "Pink flip-flops",
      accentColor: "#1A1ACF"
    }
  }
})

Variables you pass this way are also made available as CSS custom properties. So you could do something like this in your component's HTML and CSS:

<div class="productHeader">{{theme.custom.productTitle}}</div>

.productHeader {
  background-color: var(--theme-accentColor)
}

Check out our documentation on passing data to themes to learn more.

Other improvements and fixes

• Fixed styling issues in Safari
• Fixed an issue where an ampersand in an HTML tag attribute within a theme could cause an error
• Fixed an issue where whitespace wasn't preserved in email templates
• Fixed an issue where TalkJS would crash when switching conversations while the reply bar was visible
• Fixed a crash related to the voice message recorder