Bird Pickup & Delivery Bird Pickup & Delivery
Help What's New Roadmap Book Status
Back to Getting Started
Getting Started

How to Switch from the Legacy Widget to the Current Widget

Updated July 25, 2026

The current Bird widget is a complete rebuild — fast, scalable, and packed with new capabilities like the product page widget and a pickup store finder. All new installs already run it by default. If your store still runs the older legacy widget, this guide shows you how to switch.

ℹ️

Switching is one-way. Once you enable the current widget, the store cannot be moved back to the legacy widget from settings — reach out to us if you ever need to.

Step 1: Enable the Current Widget

  1. In Bird, go to Settings → Widget Placement
  2. Under Cart Page, check Enable Widget V2
  3. A permissions dialog appears — click Update to approve

Enable Widget V2 checkbox in Widget Placement settings

Shopify permissions dialog requesting data access for the current widget

After approving, a save bar appears at the top of the page — click Save.

ℹ️

Only stores on the legacy widget see the Enable Widget V2 checkbox. If you don’t see it, your store already runs the current widget — you’re all set.

Step 2: Install the Widget in Your Theme

  1. In Settings → Widget Placement, under Cart Page, select your active theme from the dropdown
  2. Click Manage widget in theme — this opens the Shopify theme editor
  3. In the theme editor, confirm the Bird app embed is enabled
  4. Save the theme

Next Steps

Once you’ve switched, these features are available to enable in your settings.

Bird Order Details Block

The details your customers select in the Bird widget appear in the Bird Order Details block right on Shopify’s order page — so you can see them without opening the Bird app.

Bird Order Details block on a Shopify admin order page

What Changes for Your Customers

Cart widget on the cart page showing delivery options and date selection

  • Fast and scalable — built to handle high-traffic stores without slowdowns
  • A completed selection is preserved if the customer navigates away and returns to the cart
  • The customer’s zip or postal code is remembered for the current browsing session, so they don’t have to re-enter it as they shop
  • Cleaner UI that works seamlessly with modern Shopify themes

Related Articles

Troubleshooting

Enable Widget V2 checkbox is greyed out — Multi-location is not enabled. Enable it in Settings → Locations.

Widget not appearing after enabling — Go to Settings → Widget Placement, click Manage widget in theme, and re-save the theme in the Shopify editor.

Permissions prompt did not appear — Toggle the Enable Widget V2 checkbox off and on again to re-trigger the permission prompt.

Was this article helpful?

Related articles

Complete Guide to our Pricing & Plans Bird Pickup & Delivery: Full App Setup Guide How to Enable Bird Pickup and Delivery Date Widget in Your Shopify Theme Set Up Different Schedules for Multiple Store Locations Verify Your Widget Setup: Place a Test Order