Altered Digital Migration to Sanity

Description

Altered Digital Migration to Sanity is the companion plugin for the Altered Digital migration service. It provides a guided 11-step wizard that analyzes your WordPress site, generates a quote, connects to your Sanity project, migrates your content, and provides post-migration tooling.

This plugin is an interface to the Altered Digital migration service (a paid service). The content transformation, page builder parsing, SEO extraction, and redirect handling are performed by the Altered Digital Worker (a Cloudflare Worker) and AI service. The plugin sends your WordPress content to that service for processing.

This plugin is not affiliated with or endorsed by Automattic, the WordPress Foundation, or Sanity.io.

What data is sent to the external service?

When you trigger a migration, the plugin sends the following data to the Altered Digital Worker:

• Post content — title, body (raw HTML, Gutenberg blocks, or page builder data), excerpt, slug, publish date, and status for each exported post/page.
• Taxonomy terms — categories and tags (name, slug, description, parent).
• Authors — display name, slug, and bio for post authors.
• Media — featured images and inline images (uploaded by reference URL to your WP site, then transferred to Sanity’s asset CDN).
• ACF fields — Advanced Custom Fields field group data associated with exported posts.
• SEO metadata — Yoast or Rank Math SEO data (meta title, meta description, canonical URL, Open Graph data, Twitter card, schema.org JSON-LD) extracted from post meta.
• Redirect rules — redirect rules from the Redirection plugin (if installed), sent as a batch to the Worker.
• Site analysis — when you click “Analyze my site”: post counts per type, page builder distribution, ACF field inventory, theme name/version, WordPress version, and PHP version.

Content is only sent when you trigger it (clicking wizard buttons) or when the auto-sync feature is explicitly enabled in the Content Settings step (it is off by default). Separately, while you are actively using the migration wizard the plugin sends limited, non-content usage events — see “Usage telemetry” below. Nothing at all is sent on plugin activation.

The plugin does not send: user passwords, API keys stored in other plugins, Stripe/PayPal/SMTP credentials, or any other sensitive post meta. A filter strips known sensitive meta keys before sending post data.

Usage telemetry

The plugin sends limited usage events to the Altered Digital service so installs can be linked to their migration account:

• When — only while you are actively working in the migration wizard, signed in to your Altered Digital account: when a wizard milestone completes (login, scan, quote, payment, connect, content, migrate, approve, paid_full) and once when you connect your Sanity project. No telemetry is sent on plugin activation or page load — the activation-time install ping was removed in 2.4.1.
• What — a stable install ID (a random UUID stored in your own database), your site URL, WordPress/PHP/plugin versions, a multisite flag, and the milestone name. No post content, media, user data, or settings are included.
• How — a fire-and-forget background POST with a 2-second timeout. It never blocks page loads or wizard steps, and failures are silent.
• Where — the Altered Digital Worker endpoint configured on the plugin Settings page.
• Self-host mode — telemetry is skipped entirely when no service URL is configured.

External services

This plugin sends data to the following external services. Each service’s terms of service and privacy policy govern the data it receives:

• Altered Digital Worker (Cloudflare Worker, https://wp-to-sanity-migration.ryan-600.workers.dev) — receives the content you choose to migrate, transforms it, and writes it to your Sanity project. Sent when you trigger a migration or enable auto-sync.
  • Terms of Use: https://wptosanity-docs.vercel.app/docs/terms
  • Privacy Policy: https://wptosanity-docs.vercel.app/docs/privacy
• Altered Digital AI Service (Vercel) — performs site analysis, quote generation, QA checks, and AI-assisted content transformation for blocks below the confidence threshold. Sent when you run the Analyze step or a migration.
  • Terms of Use: https://wptosanity-docs.vercel.app/docs/terms
  • Privacy Policy: https://wptosanity-docs.vercel.app/docs/privacy
• Supabase (https://supabase.com) — handles account authentication (signup/login) for the Altered Digital platform. Your account email and password are sent to Supabase’s hosted auth service.
  • Terms of Service: https://supabase.com/terms
  • Privacy Policy: https://supabase.com/privacy
• Stripe (https://stripe.com) — processes upfront and final payments for the migration service. You are redirected to Stripe Checkout; the plugin does not handle or store card data.
  • Legal (Terms): https://stripe.com/legal
  • Privacy Policy: https://stripe.com/privacy
• Your Sanity project (https://www.sanity.io) — migrated content is written to the Sanity project you own, using the API token you provide at connect. Sanity.io’s own terms apply to your use of their platform.
  • Terms of Service: https://www.sanity.io/legal/tos
  • Privacy Policy: https://www.sanity.io/legal/privacy

Page builder support

• Gutenberg — native block editor content
• Elementor — full JSON widget tree parsing
• WPBakery — shortcode-based content parsing
• Divi 4 — shortcode-based content parsing
• Divi 5 — block-comment-based content parsing
• Beaver Builder — full layout data parsing

SEO support

• Yoast SEO — all meta fields extracted and mapped to Sanity’s seo object
• Rank Math SEO — all meta fields extracted and mapped to Sanity’s seo object

Redirect support

• Redirection plugin — active redirect rules extracted and migrated to Sanity redirect documents

Features

• 11-step guided migration wizard
• Automatic site analysis with page builder detection
• Quote generation with upfront and final payment
• Sanity project connection (Project ID, dataset, API token)
• Staging dataset protection (content held in staging until final payment)
• Content type and taxonomy selection
• Full-site or incremental migration
• Real-time migration progress dashboard
• Auto-sync mode (automatic content sync on post publish/update)
• Post-migration tooling:
  • Claude Connect — MCP hand-off for Claude Desktop
  • Schema Preview — AI-generated Sanity schema review
  • Migration Log — per-post migration history
• WP-CLI commands (wp altered-digital export|analyze|status)
• Multisite support (network-activate creates tables on all sites)
• Self-host mode for enterprise deployments