What Shopify Removes When You Uninstall an App
When you remove an app from Settings → Apps and sales channels in your Shopify admin, Shopify revokes the app's access token immediately. From that moment the app can no longer read or change anything in your store, even if its servers keep running. Shopify also runs a set of cleanup tasks on its side. According to Shopify's developer documentation, uninstalling deletes the app's registered webhooks, its script tags and its Shopify admin links.
If the app was built on theme app extensions (the app blocks and app embeds you switch on in the theme editor), its storefront code goes with it. Shopify's Online Store 2.0 documentation states it plainly: when a merchant uninstalls the app, the app code is removed with it. That is one of the main reasons Shopify pushed apps towards this model.
| Item | After uninstall |
|---|---|
| App access token | Revoked immediately |
| Webhooks the app registered | Deleted by Shopify |
| Script tags | Deleted by Shopify |
| App blocks and app embeds (theme app extensions) | Removed with the app |
| Code the app pasted into theme files | Often left behind |
| Images uploaded into Shopify's product media | Stay on the product |
| Images hot-linked from the app's own servers | Can break when the app stops serving them |
| Your data on the app's servers | Up to the app (see below) |
The rows marked "often left behind" and "can break" are where merchants get hurt. Shopify can only clean up what it manages. It has no record of a snippet an older app wrote into theme.liquid, and it cannot keep serving a picture that lives on someone else's server.
Where Your Product Images Actually Live
The single most important question about any image app is this: does it put the finished file into Shopify, or does it point Shopify at a file it keeps?
Uploaded into Shopify
- The app sends the image to the product through the Admin API
- Shopify copies the file onto its own CDN
- The image, alt text and position belong to your product
- Uninstalling the app changes nothing on the storefront
Served by the app
- The product page loads the picture from the app's servers or a widget
- The gallery may only exist inside an app block or script
- Your product record may hold no copy of the file at all
- Uninstalling, or the app shutting down, can leave gaps
You can tell which kind you have in about a minute. Open a product in your Shopify admin and look at its Media section. If the edited images appear there as ordinary product media, Shopify holds them and they are safe. Then open the product page on your storefront, right-click the main image and copy its address. A Shopify-hosted image loads from cdn.shopify.com (or your store's own domain). An address on another domain means the picture is being served from outside your store.
Retouchable's push to Shopify is the first kind. When you send a finished image to a product, it goes through the product images endpoint of the Admin API, Shopify fetches the file and stores it on its own CDN, and the image lands with the filename, alt text and position you set. Position 1 makes it the featured image that drives collection grids and search results. Because the file now belongs to the product, removing Retouchable leaves every pushed image exactly where it is. For more on how position and gallery order work, see Controlling Shopify Image Position and Gallery Order.
Push one edited image to a draft product, then check the product's Media section in your admin. If it is there, the app's output will survive the app. If the image only appears on the storefront and not in Media, ask the developer what happens to it on uninstall.
What the App Should Delete on Its Side
Revoking the token stops an app from touching your store, but it does not erase what the app already copied to its own database. For that, Shopify relies on a set of webhooks that every app listed in the Shopify App Store must handle:
- app/uninstalled fires when you remove the app, so it can clean up straight away.
- shop/redact is sent by Shopify 48 hours after a store owner uninstalls the app, asking it to erase the data it holds for that store.
- customers/data_request and customers/redact cover your shoppers' personal data, when a customer asks to see or delete it.
Shopify also asks apps to confirm a compliance request straight away and complete it within 30 days. In practice, a well-built image app should hold very little: your shop domain, an encrypted access token and perhaps your store name. An image app has no reason to hold your customers' names, addresses or orders, and the permissions it asks for at install time tell you whether it even could. We cover reading those scopes in What Shopify App Scopes Mean for Product Data.
Here is what Retouchable does, as a reference point. It asks only for read_products and write_products, so it has no access to orders, customers or payments, and it stores no shopper data. The two customer webhooks are acknowledged with nothing to export or erase. When app/uninstalled or shop/redact arrives, Retouchable deletes the connection for that shop: the shop domain, the encrypted token and the shop name, along with any half-finished connection attempts. Every webhook is checked against Shopify's signature before anything is deleted, and a failed delete answers with an error so that Shopify tries again.
What Stays in Your Account After You Uninstall
"Uninstall" ends the connection between two systems. It is not the same as closing your account with the app, and it should not be. Many image apps, Retouchable included, are separate products with their own accounts, where the photos you uploaded and the results you made are your working library rather than Shopify data.
After you uninstall Retouchable from Shopify:
- Your Retouchable library stays. Originals, edits and saved results belong to your Retouchable workspace, not to the Shopify connection.
- Your push history stays. The record of which image went to which product, with its filename and alt text, remains in your account, so you can see what you sent and reconnect later without starting over.
- The connection is gone. The store and its token are deleted, so nothing can be pushed until you connect again.
If you want your library and history deleted too, that is a separate request: deleting the account or its files inside the app. Before you do that, download anything you might need. A product image you can re-edit from the original is far more useful than one you can only download from your storefront at whatever size your theme served it.
What do you store about my shop? What do you delete when I uninstall, and when? What stays in my account afterwards, and how do I delete it? A developer who cannot answer all three in plain words has not thought about it.
Disconnecting Is Not the Same as Uninstalling
Many apps offer a Disconnect button in their own settings, and it is easy to assume it does the same thing as uninstalling. Often it does not.
In Retouchable, Disconnect removes the store connection from your workspace on Retouchable's side. It is useful if you want to connect a different store or stop pushes from a shared workspace. It does not reach into Shopify, so the app may still appear under Apps and sales channels in your Shopify admin until you remove it there. Uninstalling from the Shopify admin is the step that revokes the app's access inside Shopify and starts Shopify's own cleanup.
| Action | Where | Effect |
|---|---|---|
| Disconnect | Inside the app | The app forgets the store; it may still be listed in Shopify |
| Uninstall | Shopify admin | Token revoked, Shopify cleanup runs, app told to delete store data |
| Delete account | Inside the app | Your library and history at the app are removed |
If your goal is to make sure an app can never touch your catalog again, uninstall it from the Shopify admin. If your goal is to stop using the app entirely and leave nothing behind, do that and then delete your account with the app.
A Checklist for Before and After You Uninstall
Run this list whenever you remove any app that has touched your product imagery. It takes about fifteen minutes for a typical store and can save a weekend of re-uploading.
Before you uninstall
- Check where the images live. Open three or four products the app worked on and confirm the images appear in each product's Media section and load from Shopify's CDN.
- Export what only the app holds. Download originals, layered files or edits you may want to rework later.
- Note the gallery layout. If the app drove a custom gallery, zoom viewer or 360° spinner, screenshot a product page so you know what it looked like and what you need to replace.
- Check your theme for app blocks. In the theme editor, note which sections and app embeds belong to the app. These should disappear on uninstall; anything else may not.
- Duplicate your live theme. A copy in your theme library gives you a clean point to return to if removing leftover code goes wrong.
After you uninstall
- Load your storefront. Check the home page, a collection page and a few product pages, on a phone as well as a desktop, for broken images or empty spaces.
- Search your theme code. Shopify's own guidance is that uninstalling an app from the admin doesn't always remove its code from the theme. Look in
layout/theme.liquidfor script tags with the app's name or domain, and in thesnippets/folder for files you don't recognise, along with the{% render %}tags that load them. - View the page source. Search the HTML for the app's domain to confirm nothing still loads from it.
- Re-check your featured images. Collection grids and in-store search use each product's first image. If that slot was filled by an app widget rather than product media, the grid will show it immediately.
Code from an uninstalled app can keep loading on every page with nothing to run, adding requests and weight for no benefit. Clearing it out is one of the cheapest page-speed wins available. See Shopify Image File Size and Page Speed for the image side of the same problem.
If Images Went Missing After an Uninstall
If you have already uninstalled an app and found gaps, the fix depends on which of the two image models it used.
The images were never in Shopify. If the product's Media section is empty or holds only your old photos, the app was serving the edited images itself. Reinstalling the app may bring them back temporarily, which gives you a window to download them and upload them to the products properly. If the app is no longer available, go back to your originals and re-edit them in a tool that writes into Shopify's product media.
The images are in Shopify but look wrong. If the media is there but the gallery or zoom looks broken, the problem is usually leftover theme code or a removed app block rather than the photos themselves. Restore the theme copy you made, or remove the orphaned snippets and render tags.
The wrong image is now featured. If an app managed gallery order through its own widget, Shopify falls back to the product's own first image. Reorder the media in the product admin, or push the right image to position 1. Our guide to rolling back and recovering Shopify product images covers restoring a previous set step by step.
The pattern is consistent: an app that writes finished files into your product media and draws on the storefront only through theme app extensions leaves almost nothing to clean up by hand. That is the standard worth holding every image app to before you install it, not after.