# Base Components: Migrate `ui` components

Aura components in the `ui` namespace are deprecated. Support for these deprecated components ended on May 1, 2021.

When you migrate Aura components from the `lightning` and `ui` namespaces, use its LWC equivalent. For example, replace `ui:button` and `lightning:button` with the LWC equivalent: `lightning-button`, `lightning-button-icon`, or `lightning-button-icon-stateful`.

Table 1. Mapping of Aura components in the `ui` namespace

| Aura Component                                                                                                                    | LWC                                                                                                                                                                                                                                                    | Usage                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [ui:actionMenuItem](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-action-menu-item)       | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:button](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-button)                         | lightning-button-*                                                                                                                                                                                                                                     | Use `lightning-button`, `lightning-button-icon`, or `lightning-button-icon-stateful`. For button groups, use `lightning-button-group`.                                                                                                                                                                                                                      |
| [ui:checkboxMenuItem](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-checkbox-menu-item)   | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:inputCheckbox](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-checkbox)          | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `checkbox`, `toggle`, or `checkbox-button` type instead. For checkbox groups, use `lightning-checkbox-group`.                                                                                                                                                                                                                    |
| [ui:inputCurrency](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-currency)          | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `number` type and `currency` formatter instead.                                                                                                                                                                                                                                                                                  |
| [ui:inputDate](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-date)                  | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `date` type instead.                                                                                                                                                                                                                                                                                                             |
| [ui:inputDateTime](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-date-time)         | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `datetime` type instead.                                                                                                                                                                                                                                                                                                         |
| [ui:inputDefaultError](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-default-error) | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with built-in field validation instead.                                                                                                                                                                                                                                                                                               |
| [ui:inputEmail](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-email)                | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `email` type instead.                                                                                                                                                                                                                                                                                                            |
| [ui:inputNumber](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-number)              | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `number` type instead.                                                                                                                                                                                                                                                                                                           |
| [ui:inputPhone](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-phone)                | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `phone` type instead.                                                                                                                                                                                                                                                                                                            |
| [ui:inputRadio](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-radio)                | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `radio` type instead. For radio groups, use `lightning-radio-group`.                                                                                                                                                                                                                                                             |
| [ui:inputRichText](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-rich-text)         | [lightning-input-rich-text](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input-rich-text)                                                                                                              | Use `lightning-input-rich-text` instead. To create custom toolbar buttons, use `lightning-rich-text-toolbar-button-group`.                                                                                                                                                                                                                                  |
| [ui:inputSecret](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-secret)              | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `password` type instead.                                                                                                                                                                                                                                                                                                         |
| [ui:inputSelect](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-select)              | [lightning-combobox](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-combobox) or [lightning-select](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-select) | To create a list of options for single selection, use `lightning-combobox`. To enable single and multiple selection on a menu of options, use `lightning-select`.                                                                                                                                                                                           |
| [ui:inputSelectOption](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-select-option) | [lightning-combobox](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-combobox) or [lightning-select](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-select) | To create a list of options for single selection, use `lightning-combobox`. To enable single and multiple selection on a menu of options, use `lightning-select`.                                                                                                                                                                                           |
| [ui:inputText](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-text)                  | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `text` type instead.                                                                                                                                                                                                                                                                                                             |
| [ui:inputTextArea](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-text-area)         | [lightning-textarea](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-textarea)                                                                                                                            | Use `lightning-textarea` instead.                                                                                                                                                                                                                                                                                                                           |
| [ui:inputURL](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-input-url)                    | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `url` type instead.                                                                                                                                                                                                                                                                                                              |
| [ui:menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu)                             | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:menuItem](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu-item)                    | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:menuItemSeparator](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu-item-separator) | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-divider` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                          |
| [ui:menuList](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu-list)                    | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:menuTrigger](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu-trigger)              | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:menuTriggerLink](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-menu-trigger-link)     | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:message](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-message)                       | [lightning/platformShowToastEvent](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-platform-show-toast-event)                                                                                             | Use `lightning/toast` with `lightning/toastContainer` in LWR sites.                                                                                                                                                                                                                                                                                         |
| [ui:outputCheckbox](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-checkbox)        | [lightning-input](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input)                                                                                                                                  | Use `lightning-input` with `checkbox` type and set `readonly` to `true`.                                                                                                                                                                                                                                                                                    |
| [ui:outputCurrency](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-currency)        | [lightning-formatted-number](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-number)                                                                                                            | Use `lightning-formatted-number` with `style` set to `currency`.                                                                                                                                                                                                                                                                                            |
| [ui:outputDate](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-date)                | [lightning-formatted-date-time](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-date-time)                                                                                                      | Use `lightning-formatted-date-time` instead.                                                                                                                                                                                                                                                                                                                |
| [ui:outputDateTime](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-date-time)       | [lightning-formatted-date-time](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-date-time)                                                                                                      | To include the date in the output, use `lightning-formatted-date-time`. Otherwise, use `lightning-formatted-time`.                                                                                                                                                                                                                                          |
| [ui:outputEmail](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-email)              | [lightning-formatted-email](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-email)                                                                                                              | Use `lightning-formatted-email` instead.                                                                                                                                                                                                                                                                                                                    |
| [ui:outputNumber](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-number)            | [lightning-formatted-number](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-number)                                                                                                            | Use `lightning-formatted-number` instead.                                                                                                                                                                                                                                                                                                                   |
| [ui:outputPhone](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-phone)              | [lightning-formatted-phone](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-phone)                                                                                                              | Use `lightning-formatted-phone` instead.                                                                                                                                                                                                                                                                                                                    |
| [ui:outputRichText](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-rich-text)       | [lightning-formatted-rich-text](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-rich-text)                                                                                                      | Use `lightning-formatted-rich-text` instead.                                                                                                                                                                                                                                                                                                                |
| [ui:outputText](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-text)                | [lightning-formatted-text](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-text)                                                                                                                | Use `lightning-formatted-text` instead.                                                                                                                                                                                                                                                                                                                     |
| [ui:outputTextArea](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-text-area)       | [lightning-formatted-text](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-text)                                                                                                                | Use `lightning-formatted-text` instead.                                                                                                                                                                                                                                                                                                                     |
| [ui:outputURL](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-output-url)                  | [lightning-formatted-url](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-formatted-url)                                                                                                                  | There are several ways to work with links. <ul><li>Custom onclick event handler: Use the HTML anchor tag `<a>`</li><li>Navigate in Lightning Experience: Use `lightning-navigation`</li><li>Email address with `mailto:` protocol: Use `lightning-formatted-email`</li><li>Phone number with the `tel:` protocol: Use `lightning-formatted-phone`</li></ul> |
| [ui:radioMenuItem](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-radio-menu-item)         | [lightning-button-menu](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-button-menu)                                                                                                                      | Use `lightning-menu-item` with `lightning-button-menu` instead.                                                                                                                                                                                                                                                                                             |
| [ui:spinner](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/ui-spinner)                       | [lightning-spinner](https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-spinner)                                                                                                                              | Use `lightning-spinner` instead.                                                                                                                                                                                                                                                                                                                            |

**See Also**

[Base Components: Aura Vs Lightning Web Components](/docs/platform/lwc/guide/migrate-map-aura-lwc-components.md)
