Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

Cookies and the Web Storage API in Webchat 3.x.x


Flex Webchat 3.x.x persists some client-side data to create a better user experience. This can cause issues when your customers have the Web Storage API disabled. This page describes how Flex Webchat uses cookies, local storage, and session storage.


Overview

overview page anchor

Flex Webchat uses each storage strategy in the following ways:

Cookies

cookies page anchor

Flex Webchat does not use cookies. If your users block the browser from using cookies, this should not cause any issues.

Used to persist chat after page reload and for error logging. Disabling local storage will cause a degraded experience, especially on page reloads, but Webchat should still function.

Required for the proper functioning of Webchat (e.g., opening and maintaining the WebSocket). Disabling session storage prevents Webchat from functioning.


Storage TypeDefinitionMax SizeExpiration
CookiesStores data that has to be sent back to the server with subsequent XHR requests4KBExpires at a chosen expiration date, or when the session ends in the case of a session cookie
Local StorageStores data in the browser across sessions. Opening two tabs with the same URL will share local storage. Data is never sent to the backendUp to 5 MB of data in the browser in key/value pairsData never expires but can be cleared by the user
Session StorageTemporarily stores data in the browser. Data does not persist across sessions (i.e., two tabs with the same URL will have different session storage.) Data is never sent to the backend.Stores up to 10 MB of data in the browser in key/value pairsData expires when the session ends, e.g., if the browser tab is closed

Information stored in local storage

information-stored-in-local-storage page anchor
  • twilio-flex-cf
  • loglevel:twilio-flex-webchat-ui
  • loglevel

Information stored in session storage in Webchat

information-stored-in-session-storage-in-webchat page anchor
  • <id>::map::<id>.channels
  • <id>::map::<id>.info
  • <id>::document::<id>.channel
  • <id>::map::<id>.roster
  • <id>::list::<id>.messages