Removing an app

Manage → Apps → Uninstall on the app's card, or from inside the app's own screen.

The confirmation says:

"Uninstall {app}? It will lose access to this store immediately."

"Immediately" is literal: the install is re-read on every API call, so a token the app is holding stops working on its next call. There is no expiry window to wait out.

This page is about marketplace apps. Built-in apps (Mail, Booking, Payments…) have their own dialog — "Nothing is deleted — your settings and translations are kept, and installing it again brings everything back" — and some refuse to uninstall while still at work: Payments while a gateway is on, Multilingual while the store publishes more than one language, Booking while a booking form exists, Loyalty while the program is enabled. Each app's page says so.

If the app has placed blocks on your pages

The dialog lists them first:

"This app puts {n} blocks on your pages; uninstalling removes them:"

with the affected pages named.

This is the part to read properly. A block an app contributes is a reference to that app, not a copy of its markup sitting in your page. The app goes and the block goes with it — and where it stood, your page has a gap.

If it is a significant piece of a page, prepare the replacement before uninstalling rather than looking afterwards.

The app's data

Some apps store values on your store — star ratings, specifications, badges — and your pages display them.

Uninstalling stops that data resolving immediately and deletes nothing. Two halves, and the second matters:

• Nothing breaks. Every element bound to one of the app's values falls back to the text it was authored with — not to an empty gap.
• Reinstalling brings it all back, with no action from anyone. The data was there the whole time, simply not resolving while the app was away.

The data is kept indefinitely. There is no button on screen to delete it; to purge it you call the store's manage API — a decision of its own, not a consequence of uninstalling.

When you cannot uninstall

"You don't have permission to uninstall apps on this store."

Your role is not sufficient. Ask an admin or the store's owner.

When an app stops without you removing it

Three reasons:

The developer withdrew a version. Withdrawal is deliberately asymmetric: nobody new can land on that version, but every store already running it keeps running it. Pulling a live block out from under your page would be a worse cure than the disease. The Versions dialog labels that version Withdrawn.

The app was suspended. Its screen says "it may have been suspended or its version withdrawn"; as far as blocks on your pages go, it behaves like an uninstall.

The role of whoever installed it was reduced. The app does not disappear, but it loses access — usually showing up as a feature that stops working rather than a message. See What you are granting.

Published pages do not change straight away

Removing an app affects the content you are editing. Published pages keep what they have until the next publish — the same rule as global sections. After removing an app that placed blocks, republish so the live storefront matches the editor.