On this page
Why this happens or what changed
Older guidance told developers to contact Shopify Support to begin delisting. The new self-service path separates discoverability from installed-app lifecycle. Removing the listing cannot be undone; relisting requires submitting the app for review as a new app. Shopify says it does not automatically email your merchants, cancel their charges, or uninstall the app for you.
Practical fix
- Export a complete inventory of installed stores and current app subscriptions before changing distribution.
- Choose a sunset date at least 30 days ahead and send an initial notice explaining what functionality and data access will stop.
- Use
appSubscriptionCancelfor active subscriptions as appropriate; reconcile any external billing separately. - Plan a controlled
appUninstallprocess for remaining installations before the sunset date, with retries and audit records. - Preserve required merchant data only under applicable retention rules and provide a documented migration/export path where feasible.
- Confirm internal support, incident response, and replacement recommendations are ready before clicking the irreversible removal action.
Production example
Use a dated rollout checklist: Day 0 remove the listing and send notice; during the notice period provide exports, replacement instructions, and reminders; before sunset reconcile subscription cancellations and remaining installs. Do not equate an App Store search returning no results with successful offboarding.
How to test this
- On a non-production app or controlled test setup, document listing visibility separately from an existing installation.
- Verify the configured sunset date is at least 30 days in the future.
- Audit installed-store counts and subscription state before and after cancellation actions.
- Check that merchant notices reached the intended contacts and include the actual date.
- Verify remaining installations are uninstalled using the supported API and confirm any downstream integrations are disabled.

