---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/flex/admin-guide/setup/voice/dialpad-migration-guide#article
headline: Migrate from the Legacy Dialpad
description: Remove legacy dialpad and enable Flex's new native Dialpad component for outbound calls.
url: https://www.twilio.com/docs/flex/admin-guide/setup/voice/dialpad-migration-guide
inLanguage: en
dateModified: 2026-07-17T03:41:20.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Migrate from the Legacy Dialpad

Flex has a native Dialpad component that supports outbound dialing. If you're using a former iteration of the Dialpad, follow the steps below to migrate to the native functionality.

## Remove the Legacy Dialpad

In order to migrate, you need to remove the Legacy dialpad from your contact center. You may have a legacy Dialpad that was **enabled as a pre-release feature**, or **added as a custom plugin to your Flex environment**.

## Turn off the Legacy dialpad pre-release feature

![Flex Admin View highlighting 'Manage' button for pre-release features.](https://docs-resources.prod.twilio.com/2c0f06a280add9ce29be1815b8525fa2abd2e96cd03031f61562873bc524dca0.png)

1. In the Agent view, you should see a Legacy Dialpad. Navigate to the Admin View.

![The Flex Admin View with an arrow pointing to a button labeled 'manage' for pre release features.](https://docs-resources.prod.twilio.com/baa0e8f19075a5d10f173f6471ba7ef667478aeea7f2bea7df05171994f0fdfd.png)

2. Select **Manage** under the Pre-Release Features Option.

![Arrow pointing to the toggle switch for enabling the dialpad under pilot features in Twilio Flex.](https://docs-resources.prod.twilio.com/0bbfb7bff6bc340919269df34dbf66c6dc36e4b1b7b4c7cbbea79b564bf83097.png)

3. **Toggle** the switch for the Dialpad so that it is off/disabled (circle is on the left hand side.)

The dialpad pre-release feature should now be turned off. If you still see a Legacy dialpad, then you may have released the dialpad via a Plugin.

## Remove an existing Dialpad Plugin

If you've deployed a custom version of the Dialpad via a [Flex Plugin](/docs/flex/developer/ui-and-plugins), you'll need to remove it from your Flex environment.

> \[!CAUTION]
>
> Ensure that you have an up-to-date copy of the Legacy Dialpad Plugin code available **before** you delete your Plugin. This will ensure that you can rollback your contact center to use the Legacy Dialpad if necessary.

If you are using an earlier version of the Plugin Builder, check your [Runtime Assets in the Twilio Console](https://www.twilio.com/console/assets/public) and remove the Dialpad plugin.

If you are using the [Plugin Builder v3](/docs/flex/developer/ui-and-plugins) to deploy your Dialpad plugin, navigate to the Plugin folder in your terminal, and in your terminal run:

```bash title="Remove the Dialpad plugin"
npm run remove
```

If you've hosted a Plugin on your own CDN, you'll need to remove the plugin from your CDN.

## Enable the Native Dialpad

After you've removed your Legacy dialpad, [follow the standard instructions for enabling the native Flex dialpad](/docs/flex/admin-guide/setup/voice/dialpad/enable).