# Deprecated Islands

> Storefront islands retained for legacy compatibility but not for new pages

Canonical URL: https://c22dfdd27662:3005/islands/deprecated

These islands remain available so existing pages can render while they are
migrated. Do not select them for new storefront pages. Prefer static HTML,
CSS, `data-behavior` primitives, or the replacement island shown below.

The generated schema catalog marks these islands with `deprecated: true`, and
the MCP discovery catalog excludes them from active recommendations.

## Deprecated island catalog

| Island | Replacement | Status |
|---|---|---|
| `BackToTop` | Native anchor link with CSS `scroll-behavior` | Legacy only |
| `Carousel` | CSS scroll-snap or a specialized commerce/media island | Legacy only |
| `CartDrawer` | Default profile-driven Cart V2 | Legacy Cart V1 only |
| `Countdown` | `CountdownTimer` | Legacy only |
| `Marquee` | CSS animation with static HTML | Legacy only |
| `StatCards` | HTML/CSS with optional `IntersectionObserver` | Legacy only |
| `Tabs` | CSS-only tabs with radio inputs or `<details>` | Legacy only |

## Migration rules

- Do not add these islands to new pages.
- Existing pages may keep them until migrated.
- Cart V2 is enabled by default. Do not author `CartDrawer`, an inline cart
  profile section, or a Cart V2 flag in new page source.
- Keep a deprecated island only when editing a legacy page that already uses
  it and migration would be a separate change.

The supported [FAQ island](/islands/content/faq) replaces custom accordion
implementations for new pages.

For a back-to-top control:

```html
<a href="#page-top">Back to top</a>
```

## Legacy migration reference

This is an example of the source format for an existing Cart V1 page only. Do
not copy it into a new page:

```html
<lx-island name="CartDrawer">
  <script type="application/json">
    {"items":[]}
  </script>
</lx-island>
```
