Skip to content

Uninstalling & Data ​

What Shaped Recommend stores, what deactivating does, what deleting removes, and the one setting that decides.

Deactivating vs deleting ​

These are very different, and only one of them can lose data.

ActionWhat happens
DeactivateThe plugin stops loading and every block stops rendering. Your Recommendations, settings, analytics and tables are untouched. Reactivate and everything is exactly as it was.
DeleteWordPress runs the plugin's uninstall routine. It checks Clean-up Data on Deletion before it removes anything.

If you're troubleshooting, deactivate. There's no reason to delete.

To take down a single Recommendation, you don't need either. Switch it to Inactive on All Recommendations. There's no store-wide "stop everything" switch: deactivating the plugin does that job.

The setting that decides ​

Settings → Advanced → Clean-up Data on Deletion, described as "Delete all plugin data when the plugin is removed."

Default: off. With it off, deleting the plugin leaves all your data in place, so if you remove it to test a conflict and reinstall later, everything comes back.

Turning it on is deliberate:

  • It needs full administrator permissions (manage_options). A Shop manager sees the switch disabled, with the reason.
  • Switching it on asks first: "You’ll lose every recommendation, its analytics and your settings if the plugin is ever removed — even by accident. Your WooCommerce orders are never touched. We recommend keeping this off." You choose Delete Anyway or Keep My Data.
  • Switching it off again doesn't ask.

There is no undo

With the setting on, deleting the plugin removes your Recommendations and drops the analytics tables. Export your configuration first: Settings → Export / Import → Download .json Backup gives you a file you can import into any store. It only takes a few seconds, and it's the only way back.

What deleting the free plugin removes, with the setting on ​

  • Your Recommendations. They're deleted through WordPress, so their revisions and metadata go with them instead of being left behind.
  • The three database tables: sprcm_events, sprcm_event_rollups and sprcm_affinity. That's all your analytics history and mined product pairs.
  • The plugin's options: settings, Recommendation Manager configuration, the published snapshot, the schema version, internal secrets and job bookkeeping.
  • The two permissions: sprcm_manage_recommendations and sprcm_view_analytics are removed from Administrator and Shop manager.
  • Scheduled jobs: the nightly rollup and the event purge are cancelled.

Your WooCommerce orders, products and customers are never touched.

Shoppers' session records (see below) aren't deleted one by one. They expire on their own within 48 hours.

What deleting Pro removes ​

Pro owns very little, so it removes very little:

  • Its license, the sprcm_license option
  • Its scheduled jobs: order mining and the weekly license check

That's the whole list. Pro's uninstall doesn't read Clean-up Data on Deletion. That setting covers the free plugin's data, and Pro owns none of it. Every Recommendation, table and setting survives, so a store that removes Pro keeps rendering everything that only uses free features, with your configuration intact.

What Shaped Recommend stores while it's installed ​

Database tables ​

TableContentsRetention
sprcm_eventsRaw views, clicks, add-to-carts, conversions and suppressionsPurged after 90 days, except conversions, which are kept
sprcm_event_rollupsPer-day totalsKept. They're small, and they're what Analytics reads
sprcm_affinityProduct pairs mined from your orders for Store Statistics ProRebuilt from your orders. Only Pro fills it, so on the free plugin alone it stays empty

Recommendations ​

Each Recommendation is stored as a custom post type record holding its settings: filters, sorting, placement, display and conditions.

Options ​

Settings, Recommendation Manager configuration, the published snapshot, the schema version and internal secrets. Pro adds one: its license.

Session data ​

Each shopper gets a small record of what they've been shown this visit, what they've recently viewed, which popups they've closed, and which clicks are waiting to be matched to an order. It's kept for 48 hours at most. The visit itself, which the per-session limit counts against, ends after 30 minutes without activity.

Privacy, GDPR and shopper data ​

The plugin hooks into WordPress's own privacy tools:

  • Personal data export. A logged-in shopper's session record is included when you run a WordPress export request.
  • Personal data erasure. It's deleted when you run an erasure request. Only this plugin's record is removed; the shopper's cart and checkout data aren't affected.
  • The WP Consent API. The plugin registers with it and classifies the session record as functional: the feature needs it to work, and nothing in it is counted or reported.

A guest's session record is keyed to an anonymous cookie that the store never links to a person, so a data request made by email address can't find it. It expires within 48 hours anyway.

What's stored about a shopper is deliberately small. There's no profile, no cross-site identifier, and nothing is sent anywhere outside your site.

Moving to another store instead of deleting ​

If you're rebuilding rather than removing:

  1. Settings → Export / Import → Export. Choose All Recommendations or Specific Recommendations, then Download .json Backup. You get sprcm-config-YYYY-MM-DD.json.
  2. On the new store, install and activate Shaped Recommend, plus Pro if you use it.
  3. Settings → Export / Import → Import. Choose Add Alongside or Replace All, then pick the file.

Licenses never travel with an export: they belong to the site, not the configuration. Analytics history doesn't travel either, because it's tied to the orders on the original store.

A clean removal, step by step ​

If you're done with the plugin and want nothing left behind:

  1. Export a backup, even if you're sure.
  2. Turn Settings → Advanced → Clean-up Data on Deletion on, and confirm with Delete Anyway.
  3. Plugins: deactivate Shaped Recommend Pro, then delete it.
  4. Plugins: deactivate Shaped Recommend, then delete it.
  5. Optionally, check your database to confirm that sprcm_events, sprcm_event_rollups and sprcm_affinity are gone.

Remove Pro before the free plugin. Pro can't run without the free plugin anyway, and doing it in this order means you won't see a dormancy notice on the way out.

Next ​