The Plugins Dashboard enables admins to manage their plugins, view the history of plugin releases, and rollback to prior deployments. This provides visibility and control of your application's version outside of a developer's command line interface.
The Plugins Dashboard manages plugins that have been deployed by the Plugins API or CLI. While the Plugins Dashboard displays all your legacy plugins, they must be migrated to use this new interface.
Navigate to the Plugins Dashboard
You can access the Plugins Dashboard by logging in as a Flex Admin.
Stage Plugin Changes
The dashboard displays all of the plugins that have been deployed to your application. Each plugin is displayed with its current status: whether the plugin is enabled and the version that is live. As you make changes to your plugin configuration, Flex will stage your changes in a "pending release".
Change a Plugin Version
Click "change version" on the plugin you'd like to modify. A panel will displaly detailed information about each version of the plugin. Select a new version and click the "add" button. This will stage the new version of the plugin for your next release.
Enable/Disable a Plugin
The "status" switch on each plugin identifies whether the plugin is active for your users. Click the row of the plugin to enable or disable the selected plugin and stage the change for your next release.
Release your new Plugin Configuration
Once you’ve selected the correct versions and enabled each plugin you want, it’s time to create a release and roll out your updates to agents.
Click the "Pending Release" button. Give the release a name and a description that you can use to remind yourself of what you changed. Finally, click "Release" and confirm the release.
The dashboard will update to reflect your changes. Your agents will receive an updated experience the next time they load Flex or refresh their browser's active page.
Roll back a Release
Flex keeps track of all the plugin updates you release to your agents. To roll back to a prior release, navigate to the "Releases" tab on the Plugin Dashboard. Each section within the "Releases" tab contains details about the plugin configuration that was live for your agents. This will include any description you provided during the release that explains the update.
On a prior release, click the "Redeploy" button. You'll see a preview of the changes that will be made to your active plugin configuration. If you’re comfortable with the changes, click "Confirm" to redeploy your prior plugin configuration. Your agents will receive an updated experience the next time they load Flex or refresh their browser's active page.
Managing Legacy Plugins
Legacy plugins were deployed using the previous methods of
npm run deploy in the Plugin Builder or dragging-and-dropping plugins into Twilio Assets. They can be identified via the
flex-plugin dependency within their
package.json. The Plugins Dashboard displays all active legacy plugins alongside plugins that are managed by the Plugins API.
Legacy plugins cannot be managed via the Plugins Dashboard until they have been migrated to use the Plugins API. That will allow you to manage the version of the plugin or disable/enable the plugin for your agents.
If you see plugins tagged as "Duplicate", this may indicate you have not completed the migration of a legacy plugin. Refer to our migration guide to remove legacy plugin assets and complete your migration.
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.