---
title: Migrate Autocomplete from Polaris React
description: Autocomplete has no supported Polaris web component migration.
source_url:
  html: >-
    https://shopify.dev/docs/apps/build/app-home/migrate-from-polaris-react/autocomplete
  md: >-
    https://shopify.dev/docs/apps/build/app-home/migrate-from-polaris-react/autocomplete.md
api_name: app-home
---

# Migrate Autocomplete from Polaris React

Autocomplete has no supported Polaris web component equivalent. Keep the Polaris React component during an incremental migration.

Don't present an `s-text-field` and `s-popover` composition as an equivalent migration. `Autocomplete` owns coordinated focus, keyboard navigation, active-option semantics, selection, filtering announcements, dismissal, and assistive-technology behavior that a visual approximation doesn't preserve.

If the application must remove Polaris React before a supported replacement exists, treat the work as a custom accessible widget rather than a component migration. Implement and test the complete [ARIA combobox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) for the application's interaction model.

***

## Remove Polaris React

Don't remove `@shopify/polaris` while an `Autocomplete` call site remains. Remove the package only after those call sites have a supported replacement or a separately reviewed custom implementation.

***