Custom Plugins Dashboard

The Custom Plugins Dashboard enables admins to manage their custom plugins, view the history of custom 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 Custom Plugins Dashboard

You can access the Custom Plugins Dashboard by logging in as a Flex Admin. Click on Plugins in the Admin dashboard.

Stage Custom Plugin Changes

The dashboard displays all of the custom plugins that have been deployed to your application. Each custom plugin is displayed with its current status: whether the plugin is enabled and the version that is live. As you make changes to your custom plugin configuration, Flex will stage your changes in a "pending release".

Change a Custom Plugin Version

Click on the custom plugin you'd like to modify. A panel will display detailed information about each version of the custom plugin. Select a new version and click "Save". This will stage the new version of the custom plugin for your next release.

Enable/Disable a Plugin

The "status" switch on each custom plugin identifies whether the custom plugin is active for your users. Click the row of the custom plugin to enable or disable the selected plugin and stage the change for your next release.

Release your new Custom Plugin Configuration

Once you’ve selected the correct versions and enabled each custom 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 custom plugin updates you release to your agents. To roll back to a prior release, navigate to the "Releases" tab on the Custom Plugin Dashboard. Each section within the "Releases" tab contains details about the custom 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 custom plugin configuration. Your agents will receive an updated experience the next time they load Flex or refresh their browser's active page.

Managing Legacy Custom Plugins

Legacy custom 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 Custom Plugins Dashboard displays all active legacy custom plugins alongside plugins that are managed by the Plugins API.

Legacy custom 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 custom plugin or disable/enable the custom plugin for your agents.

If you see custom plugins tagged as "Duplicate", this may indicate you have not completed the migration of a legacy custom plugin. Refer to our migration guide to remove legacy custom plugin assets and complete your migration.