WPChangeSync is flexible enough to act as a Git-friendly export tool, production deployment layer, content migration helper, multisite rollout system, recovery tool, and automation surface. This library maps practical scenarios to the guides and docs that support them.
Video walkthrough coming soon.
The YouTube embed will appear here.The same feature can serve different jobs. For example, workflows can power Git exports, production deploys, scheduled backups, CI triggers, multisite rollouts, and recovery drills.
Use these categories to pick the part of the catalogue that matches your situation.
| Use case | What you sync | Best starting guide |
|---|---|---|
| Git-backed builder changes Review visual site changes like code. | Bricks templates, components, settings, global styles, custom CSS, fields, media. | Git Version Control Workflow |
| Local to staging release Move approved local work into a QA environment. | Templates, components, pages, media, fields, global classes, variables. | Import from Storage |
| Staging to production deploy Push approved staging changes to live. | Selected templates/components/content plus dependencies. | Staging to Production Sync |
| Production to staging refresh Refresh staging from the current live state before new work starts. | Production templates, pages, settings, media, and fields. | Production to Staging Sync |
| Release branch review Export changes into JSON so pull requests show exactly what changed. | Git-tracked JSON exports and workflow configs. | Git Version Control Workflow |
| Client approval handoff Capture a named state before/after client approval. | Template versions, release exports, audit entries. | Template Versioning and Rollback |
| Repeatable agency launch flow Use the same deployment steps on every client project. | Workflow templates, bundles, selected integrations. | Production Release Checklist |
| Use case | What you sync | Best starting guide |
|---|---|---|
| Preflight before production writes Avoid risky live imports. | Dry runs, backups, conflict strategies, approvals, maintenance mode. | Production Release Checklist |
| Approval-gated deployment Require a person to approve live changes. | Workflow approval gates, notifications, Activity evidence. | Approval-gated Production Deploy |
| Maintenance-window release Protect visitors during broad imports. | Workflow steps with maintenance mode and timeout handling. | Maintenance Mode Release Window |
| Bad import recovery Recover from a failed or wrong import. | Backups, template versions, Activity logs, targeted restores. | Restore from Backup |
| Conflict queue review Ask a human before overwriting target data. | Prompt conflicts, diffs, per-field merge choices. | Conflict Resolution in Practice |
| Rollback a broken template Return one template to a previous known-good state. | Template version snapshots and restore commands. | Template Versioning and Rollback |
| Audit a release after the fact Answer who changed what and when. | Audit table entries, workflow run context, CSV/JSON exports. | Audit Trail and Compliance Exports |
| Use case | What you sync | Best starting guide |
|---|---|---|
| Reusable section library sync Move reusable sections between projects. | Bricks templates/components, global classes, variables, media, fields. | Sync Bricks Templates with Dependencies |
| Global style rollout Push shared design tokens and classes across sites. | Global classes, theme styles, variables, colors, framework settings. | Sync Global Styles Safely |
| Brand token update Roll out a color/type/style change to many sites. | Bricks variables, colors, typography, CSS framework tokens. | Sync Global Styles Safely |
| Component library distribution Share Bricks components across projects or teams. | Components, media, custom fonts, global classes, fields. | Sync Bricks Templates with Dependencies |
| Custom font migration Move custom fonts and files safely. | Custom fonts CPT data, font files, media references. | Custom Fonts and Bricks Capabilities |
| Security-sensitive Bricks settings Review SVG/code execution/capability settings before sync. | Bricks capabilities, settings, environment-specific options. | Custom Fonts and Bricks Capabilities |
| Builder panel workflow-on-save Export or run workflows from Bricks save events. | Workflow sync mode, builder panel settings, export queue. | Workflow-on-save and Builder Panel |
| Use case | What you sync | Best starting guide |
|---|---|---|
| Move selected pages Move only a page set rather than the whole site. | Pages, media, taxonomy terms, custom fields, parents. | Selective Push to Remote |
| Migrate media-heavy templates Keep images/SVG/video references working. | Media, inline images, featured images, ID maps, filenames, slugs. | Media Remapping and Duplicate Prevention |
| Sync ACF-powered layouts Move field definitions with templates/content. | ACF field groups, ACF post types, ACF taxonomies, pages/templates. | Sync ACF Fields with Templates |
| Move menus and navigation Copy navigation structures across environments. | Menus, menu items, linked pages, terms. | Integration Coverage Matrix |
| Copy WordPress content without Bricks Use WPChangeSync as a general WordPress sync layer. | Posts, pages, media, menus, widgets, tags, categories, fields. | Non-Bricks WordPress Workflow |
| Gutenberg site migration Sync block content on non-Bricks or mixed-builder sites. | Gutenberg content, media, reusable content, fields. | Non-Bricks WordPress Workflow |
| Plugin settings and framework config Move supported plugin/framework configuration. | Automatic.css, Core Framework, Advanced Themer, BricksForge, Gutenberg where active. | Integration Coverage Matrix |
| Use case | What you sync | Best starting guide |
|---|---|---|
| Push a shared template to many client sites Update a repeated section across a network. | Group remotes, templates/components, dependencies, batch jobs. | Multisite Rollout |
| Network-wide design-system release Roll out shared styles and components across many sites. | Global styles, variables, components, framework settings. | Multisite Rollout |
| Batch large media/content operations Avoid timeouts on heavy syncs. | Batch exports/imports, media, pages, multi-remote groups. | Batch Large Sites and Multisite Jobs |
| Shared storage between subsites Use common JSON storage with site-aware config. | Storage config, site/group overrides, integration files. | Full Automatic Sync Safety |
| Client-tier rollouts Push different changes to different client groups. | Remote groups, bundles, selected workflows. | Bundles and Workflow Config Portability |
| Multisite troubleshooting Find which site or remote failed in a network job. | Network Activity, batch jobs, remote labels, debug logs. | Debug a Failed Import |
| Use case | What you sync | Best starting guide |
|---|---|---|
| CI-triggered WordPress sync Trigger a workflow after deployment. | POST-only webhooks, workflow tokens, CI secrets, Activity logs. | Trigger Workflows from CI via Webhook |
| WP-CLI release scripts Automate status checks, dry runs, and workflow execution. | CLI status, integrations, workflows, config, dynamic commands. | Use WP-CLI in Deployment Scripts |
| Scheduled backups Export JSON snapshots regularly. | Daily export workflow, storage, backup retention, Activity. | Daily Export Backup |
| Scheduled remote sync Push or pull on a recurring schedule. | Workflow schedules, remotes, selected scope, Activity. | Full Automatic Sync Safety |
| Workflow notifications Alert teams when approvals or failures need attention. | Email/webhook notifications, approval messages, workflow events. | Workflow Notifications |
| Portable workflow definitions Move job definitions between sites. | Workflow config JSON, bundle config JSON, remotes/groups re-selection. | Bundles and Workflow Config Portability |
| Compliance reporting Export release/change history. | Audit logs, actors, targets, results, CSV/JSON exports. | Audit Trail and Compliance Exports |
| Use case | What you sync | Best starting guide |
|---|---|---|
| Learn safely with sample data Practice without touching real client data. | Demo data across templates, pages, media, menus, fields, settings. | Demo Data Sandbox |
| Validate remote credentials Debug auth, HTTPS, REST availability, and compatibility. | Application Passwords, /wp-json/, /info, /integrations, version headers. | Fix Remote Connection Issues |
| Investigate a failed import Narrow down storage, handler, PHP, conflict, or remote issues. | Activity, debug logging, PHP logs, selected retries. | Debug a Failed Import |
| Choose what to sync Understand coverage before building a workflow. | Integration manifests, active commands, dependencies, risk levels. | Integration Coverage Matrix |
| First setup for a new user Get storage, dry runs, Library, and Activity in place. | Initial config, first workflow, first dry run. | First-time Setup |
| Search for the right guide Use the public docs/guides search entry points. | Docs and guide suggestions, key operational pages. | Guides |
| Question | Use this to decide |
|---|---|
| Is production involved? | Use the Production Release Checklist and treat the use case as high risk. |
| Are there related assets? | Add media, fields, global styles, variables, custom fonts, and framework settings to the scope. |
| Will the target have local edits? | Use prompt, skip, or merge instead of overwrite. |
| Is this many sites or many items? | Use groups and batch processing. |
| Does this need to repeat? | Turn it into a workflow, bundle, or CI-triggered process. |
