Uninstall & export
Uninstalling Ayra stops all processing immediately, removes its theme blocks and account hub tabs automatically, and deletes the store’s data 48 hours later when Shopify sends the shop/redact webhook. Anything Ayra issued through Shopify’s own primitives stays with the customer: store credit, discount codes and the metafields Shopify keeps until a definition is removed. Points, vouchers, reviews, referral history and ledgers live in Ayra and are gone after the 48-hour window unless you export them first, so export before you uninstall.
What happens on uninstall
Section titled “What happens on uninstall”| On uninstall | After 48 hours | |
|---|---|---|
| Theme app blocks and the app embed | Removed from the theme by Shopify | — |
| Account hub tabs and order status blocks | Removed by Shopify | — |
| Checkout and POS extensions | Removed by Shopify | — |
| Flows and messages | Stop immediately; nothing queued is sent | — |
| Shopify store credit issued by Ayra | Stays on the customer’s Shopify account and keeps working at checkout | — |
| Discount codes issued as vouchers | Stay in Shopify as discount codes | — |
| Points balances and ledgers | Frozen | Deleted |
| Vouchers tracked in the wallet (not yet issued as codes) | Frozen | Deleted |
| Referral codes and pending rewards | Frozen; pending rewards are not granted | Deleted |
| Reviews, Q&A and media | Frozen; blocks no longer render them | Deleted, including re-hosted media |
ayra.* metafield values | Stay in Shopify until the definitions are deleted (Shopify removes app-owned definitions on uninstall; values go with them) | Removed with the definitions |
reviews.rating standard metafields | Stay (standard namespace, not app-owned); clear them if you stop showing ratings | — |
| Shopify Flow workflows using Ayra triggers | Keep existing but never fire; delete them in Flow | — |
| Billing | Ends at the end of the current period through Shopify app billing | — |
Reinstalling inside the 48-hour window restores everything as it was. After that, a reinstall starts from an empty state and you can re-import your export.
Export options
Section titled “Export options”All exports are in Ayra → Settings → Export and arrive as CSV (and a JSON bundle for the full export) by email within a few minutes.
| Export | Includes | Use it for |
|---|---|---|
| Full export | Everything below in one JSON bundle plus CSVs | Backup before uninstall; re-import on reinstall |
| Customers and wallets | Customer ID, email, points balance, store credit mirror, tier, lifecycle stage, segments | Moving to another loyalty app |
| Points history | Every ledger line with date, amount, reason, order | Audit, reconciliation |
| Referrals | Codes, links, referrer and referred IDs, status, rewards | Moving to another referral app |
| Reviews (later) | Reviews with rating, text, reviewer name, product handle, status, media URLs valid for 30 days | Moving to another review app; download media before the URLs expire |
| Opportunities and actions | Type, priority, decision, reason, outcome per customer | Analysis |
| Settings | Modules, earn rules, tiers, flows, Journey Guard rules as JSON | Re-import on reinstall |
Store credit does not need exporting; it is Shopify’s record. The customers-and-wallets export shows the mirrored balance for reference.
Before you uninstall: checklist
Section titled “Before you uninstall: checklist”- Run the full export and confirm the email arrived
- Download review media if you have reviews
- Decide what to do with store credit (it stays; tell customers) and unissued points (they are lost; consider converting them to store credit first from Loyalty → Convert balances)
- Pause flows so no customer gets a message that references a program that is ending
- Delete Shopify Flow workflows that use Ayra triggers
- Remove any theme CSS that targets
.ayra-block
Related
Section titled “Related”- Data & privacy: retention and GDPR handling.
- Plans & billing: what happens to billing.
Something missing or wrong on this page? Ask us and we will fix the docs.