This summary of features will continue to evolve as we make further enhancements to Flex UI 2.0. For details on how to migrate from Flex UI 1.x.x, see our migration guide. Also refer to the Flex UI Release Notes for v2.x.x for changes not outlined in this table.
Feature: Component library
Flex UI 1.0:
Flex UI 2.0:
Enhancements in UI 2.0:
Built using Twilio Paste tokens, primitives, components, and compositions that are completely composable.
Feature: State management
Flex UI 1.0:
Flex UI 2.0:
Enhancements in UI 2.0:
New tools provide some guardrails for your state management, helping you set up boilerplate code more easily and with better defaults.
Feature: Theme and branding
Flex UI 1.0:
config.colorTheme
config.colorTheme.overrides
Flex UI 2.0:
config.theme
config.theme.componentThemeOverride
Enhancements in UI 2.0:
New theming structure promotes consistency, customization, and web accessibility. See Theme and Branding for a list of configuration and property changes.
Feature: Plugin development
Flex UI 1.0:
4.1.2
or lower
Flex UI 2.0:
4.1.3
or higher
Enhancements in UI 2.0:
Built on upgraded components and dependencies. Click on respective Flex version tab to view the example package.json files. You can now use the Flex Plugin Library which includes ready-to-install plugins.
Feature: Messaging channels
Flex UI 1.0:
Flex UI 2.0:
Enhancements in UI 2.0:
While UI 2.0 supports Legacy Messaging, you will need to use Flex Conversations and the new Interactions API. Issues with stale or 1-participant chats have been resolved by Flex Conversations. Read the Getting Started guide for a list of enhanced messaging features. For a list of identified Chat SDK properties and methods that have changed, been removed or deprecated, see Conversations SDK in the Migration Guide.
Feature: Web accessibility
Flex UI 1.0:
N/A
Flex UI 2.0:
WCAG 2.1 AA
Enhancements in UI 2.0:
Enables customers to conform with Web Content Accessibility Guidelines (WCAG) 2.1 AA with limited development work. See Flex UI web accessibility for more details.
Feature: Degraded mode
Flex UI 1.0:
Introduced in 1.31.0
Flex UI 2.0:
Enabled for all minor versions
Enhancements in UI 2.0:
Flex UI will initialize with limited capabilities, even if some of the components like SDKs (TaskRouter, Conversations, Voice or Sync) are down. See Degraded mode for more details.
Feature: User and Activity Controls
Flex UI 1.0:
MainHeader
component
Flex UI 2.0:
Enhancements in UI 2.0:
The User Controls component was split out into two components: user-controls
now just refers to the little profile pic widget which opens up a popover with the Logout button, and activity
displays the current activity and drops down to allow for selecting a different activity. These controls have been updated for easier access and improved programmability. As this is a potentially breaking change, see the migration guide for more detailed steps on working with UI 2.0.
Feature: Messaging UI
Flex UI 1.0:
Flex UI 2.0:
Enhancements in UI 2.0:
Moving to Flex Conversations offers more customization options for the Messaging UI. There is a new dynamic Component structure and default props. See Flex Messaging UI v2 changes for more details.
Feature: TaskRouter SDK wrappers
Flex UI 1.0:
N/A
Flex UI 2.0:
New Actions and Flex Events TaskRouter SDK upgraded to ^0.5.9
Enhancements in UI 2.0:
In Flex UI 2.0, new Flex actions and events have been added to the Flex UI Actions Framework saving the need to access the TaskRouter SDK directly. See New Actions and Flex Events for TaskRouter SDK.
Feature: AppConfig
Flex UI 1.0:
Notifications.browser
warmTransfer
colorTheme
Flex UI 2.0:
Notifications.enabled
warmTransfer
is removed
theme
Enhancements in UI 2.0:
You need to update your AppConfig structure to utilize the new config structure's names and capabilities.
Feature: DownloadMedia Action
Flex UI 1.0:
Requires a message object in the payload
Flex UI 2.0:
Requires a media file as it uses Twilio Conversations
Enhancements in UI 2.0:
Uses Twilio Conversations under the hood.
Feature: InsightsPlayer Actions
Flex UI 1.0:
Convention: InsightsPlayer:<action>
Flex UI 2.0:
Convention: InsightsPlayer<action>
Enhancements in UI 2.0:
See Renamed actions for the full list of renamed Insights Player actions.
Feature: Other Flex Actions
Flex UI 1.0:
ApplyListFilters
and
ApplyListFiltersPayload
RemoveListFilters
SendMediaMessage
and
ChatActionSendMediaMessagePayload
AttachFile
Flex UI 2.0:
ApplyListFilters
and
ApplyListFiltersPayload
removed
RemoveListFilters
removed
SendMediaMessage
deprecated
AttachFiles
allows an array of files to be passed
Enhancements in UI 2.0:
Some Flex actions have been removed, deprecated, and updated for flexibility.
Feature: Voice SDK
Flex UI 1.0:
Flex UI 2.0:
Enhancements in UI 2.0:
Uses the Voice SDK which allows you to set Opus as your preferred codec. Opus generally requires less bandwidth and provides better audio quality in restrained network conditions. See Voice SDK on the Migration Guide for details on what's changed.
Feature: Flex Events
Flex UI 1.0:
yticaTokenUpdated
Flex UI 2.0:
yticaTokenUpdated
removed
Enhancements in UI 2.0:
Some Flex events have been removed.
Feature: Dialpad
Flex UI 1.0:
Legacy Dialpad Native Dialpad introduced in 1.18.0
Flex UI 2.0:
Enhancements in UI 2.0:
Legacy Dialpad implementations are no longer supported. Please migrate to the native Flex Dialpad.