Plugins Dashboard

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.

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.