Changelog

Release notes for WPChangeSync (formerly BricksSync). The current release is 2.1.2, a sync accuracy and reliability pass over the 2.1 line.1 line's editor push and pull, Migration Transforms, and cross-site media portability. The history below traces its growth from a Bricks template exporter into a full sync, migration, and automation engine.

v2.1.2July 2026

Important

  • If you synced ACF content while running 2.1.1, please update and spot-check non-media ACF fields on the destination. 2.1.1 reconnected ACF image fields to the destination media library, but treated every ACF field as a possible media field, so a relationship, number or date field whose value matched an attachment ID could be rewritten to point at an image. Remapping is now limited to genuine ACF image, gallery and file fields.

Sync accuracy

  • A skip import no longer modifies the items it skipped. Skipped pages could be moved to the top level, flattening a page tree, and their media and builder references could be rewritten.
  • Widget images, menus and page links survive a cross-site sync. Image, gallery, audio, video, navigation-menu and page-list widgets now reconnect to the destination own media, menus and pages instead of pointing back at the source site.
  • Menu items reconnect to their page in any import order. An item whose target page had not arrived yet used to become a hardcoded link to the source site and stay that way.
  • Menu theme-location assignments and single-sidebar widget files import correctly, imports no longer erase destination settings that are simply unset on the source, and builder component overrides are no longer wiped.

Workflows and batches

  • A failed run no longer reports success. It could previously show a green dialog, return HTTP 200 to a webhook, and exit 0 in the CLI.
  • Approvals are bound to the step they were granted for, so editing or reordering a workflow mid-approval can no longer apply that approval to a different step. Approval deadlines are enforced, and scheduled workflows no longer stack up a run every interval while one is still awaiting approval.
  • Runs scoped to selected items no longer pull everything on pull steps, Webhook and Shell steps can finally run, and network-level workflows can be edited.
  • Interrupted batch jobs no longer stay stuck on Running and block every later job, retry settings now behave as described, a mostly-failed job reports completed with errors, and schedules keep their cadence instead of drifting later on every late cron tick.

Reported by you

  • The Bricks Global Classes section no longer times out on large class lists, and Library file hashes are cached between page loads.
  • Storage settings no longer show the legacy brickssync-json folder from a stale option on multisite. The display now resolves storage through the same network and site precedence the sync engine uses.
  • Migrations: the permanent-delete bulk override can actually be enabled, through an explicit checkbox, the deletion preview is accurate for remote-scoped profiles, and remote pulls skip deletion propagation entirely.
  • Bundles and custom sources: bundle imports find their files again, a skip-conflicts import no longer overwrites existing components, and licence keys and API secrets are reliably excluded from custom-source exports.

Security

  • The editor Pull action no longer sends the application password when a remote redirects HTTPS to plain HTTP, matching the hardening already applied to the other push and pull paths.
  • Bundled ACF field groups can no longer overwrite an existing field group through a mismatched payload.

Quality

  • Two full independent code-review passes over the sync engine, the admin surface, workflow and batch orchestration, and every supporting subsystem. The automated suite grew from 583 to 632 tests.
v2.1.1July 2026

Added

  • An opt-in Include ACF Field Groups option, in the Library related-data dialog, the editor Push actions, and workflow steps, that bundles the ACF field group definitions your content depends on. On import they are added only when missing, so a push never overwrites the target site's existing ACF setup.

Fixed

  • ACF image, gallery, and repeater-image fields now keep their images when synced across sites. Their attachment IDs are remapped to the destination's media, the same way featured images already were, so pictures no longer arrive empty or pointing at the wrong file.
  • The Edit button on a workflow now jumps straight to the edit form and focuses it. It previously opened the form below a long list, so on pages with several workflows it looked like nothing happened.
v2.1.0July 2026

Added

  • Sync buttons in the post editor (block and classic). Push a post to a remote, pull it back with an automatic pre-pull backup, run a workflow scoped to just that post, or export it to storage, all without leaving the editor. A sync-status indicator shows whether the post is in sync, behind the target, or not there yet, and warns before overwriting a newer copy.
  • Bulk Push from the Posts list (row and bulk actions), a Gutenberg pre-publish panel, and single-item Pull by slug. Authors are preserved across sites, matched by login or email on the destination.
  • Migration Transforms (Config, then Migrations): reusable profiles that reshape content on import so differently-built sites can still sync. Rename or drop custom-field keys, merge terms from several taxonomies into one, remap attachment IDs inside galleries and fields, route one post type into another, remap relationship fields, and opt in to deletion propagation (trash by default, with a dry-run preview). Preview a profile against real files before running, define profiles network-wide, and manage them from WP-CLI.
  • Cross-site media portability. An Include Media Files option bundles each post's featured and inline images with the export. On import, featured images reconnect and inline image URLs are rewritten to the destination, so posts carry their images between sites in one pass. Fully compatible with older exports.
  • A single visibility switch for the whole editor UI: show as configured, administrators only (developer mode), or off. Safe for client sites, with a per-remote allow-editor-push-and-pull switch that is off by default. New in-plugin guides for Migrations and Editor Actions.

Security

  • A full security and reliability pass. Remote requests are validated against SSRF on every redirect, credentials are dropped if a remote downgrades from HTTPS to HTTP, and deletion propagation is capped so a misconfigured profile can never wipe a small site. Added network-admin capability checks, CSV formula-injection sanitising, storage path-traversal validation, and size-capped media downloads.
  • Cross-site imports now faithfully carry post hierarchy, term meta, and media, de-duplicated on a real path boundary with newer-wins compared in UTC. Paused batches re-queue their work instead of stalling.

Fixed

  • Item-scoped workflow runs (Library quick-run and the new editor Run-workflow action) now honour the selection at the step level instead of potentially running on everything.
  • The Preview Dependencies modal counts inline images in classic content correctly, and the export result reports how many media files were bundled. The remaining card accents render flush with rounded corners.

Changed

  • Global-styles storage writes are now atomic and domain-independent (portable URLs), matching the rest of the engine.
  • A clearer activation error when a licence is not valid for this product, explaining the usual cause and how to fix it. Admin notices, forms, and tables are themed to the plugin's design system, with accessibility improvements throughout.
  • Quality: the automated test suite now runs 571 tests and static analysis is enforced at PHPStan level 5, fixing 7 genuine defects along the way.
v2.0.1–v2.0.3June 2026

Fixed

  • Critical multisite fix: auto-sync no longer empties Bricks templates. Automatic sync is now strictly opt-in (manual by default), network defaults no longer override a site's own saved options, and imports write before deleting so a cron import can never cause silent data loss.
  • Launch-day fixes: subsite licence detection after network activation, network batch jobs running under cron, the Workflow and Bundle editors saving instead of downloading, the Pending Conflicts resolver, and per-post backup restore. Storage and activity timestamps now render in the site timezone.
  • Network remotes can be edited and deleted (case-preserving IDs), selective imports no longer leave portable-URL tokens in content, maintenance mode always exits, and the Library storage column detects exported files correctly.

Added

  • Seamless migration from BricksSync: updating in place carries your licence and activation over automatically, and the entire BricksSync configuration (storage location, file patterns, data folder, sync mode, excluded options, network config) is copied to its new home on first load. The legacy brickssync-json folder is detected automatically.
  • Portable, domain-independent storage URLs so configs move cleanly between environments.
v2.0June 2026

Added

  • Universal sync, posts, pages, menus, widgets, media, categories, tags, auto-discovered custom post types & taxonomies, and custom fields (ACF, Meta Box, ACPT); plus the full Bricks set (templates, components, settings, global styles) when Bricks is active.
  • Custom Source Builder: sync any plugin or data with no code (Settings → Data Sources).
  • Developer integration studio: export any source as a shippable integration (JSON config or a PHP registration snippet).
  • Sync engine: file-based export/import, authenticated site-to-site push/pull, remotes, groups, and multisite batch processing.
  • Workflows: multi-step runs, dry runs, approvals, notifications, per-step maintenance mode, and webhook triggers.
  • Safety: 7 conflict-resolution strategies, deep export with related data, versioning/rollback, audit trail, and activity log.
  • Modern site + network admin UI, first-run onboarding wizard, in-plugin Guides, WP-CLI, and a REST API. Remote credentials are encrypted at rest.

Fixed

  • Critical data-loss fix: imports no longer delete custom-field data missing from an incoming file, so a partial or stale export can no longer strip live page content. Page-builder structural data (Bricks, Elementor, Divi, WPBakery, Beaver Builder, Oxygen, Brizy) is always protected.
  • Network admin can again save, edit, and delete network-level remotes and workflows.
  • Onboarding wizard rebuilt so every step saves and reports honest progress.
  • Run history distinguishes dry runs, shows correct step counts, and appears in the activity feed and CSV export.
  • Uninstall now fully cleans up, including per-user settings.

Changed

  • File-based syncing is now first-class everywhere, workflows are optional.
  • Formerly BricksSync; now builder-agnostic and fully usable on any WordPress site, with Bricks features gracefully skipped when Bricks is absent.
1.4.8-beta

Fixed

  • Pushing a single component no longer silently pushes nothing.
  • Network remotes work everywhere they were previously ignored, Test Connection, workflow Run, push dropdowns, steps, dry runs, the remote picker, and batch jobs.
  • The “Getting Started” banner no longer shows on sites already configured at network level.
  • Uninstall fully removes network-level data and scheduled tasks.

Changed

  • Bricks Builder became optional, activate and use WPChangeSync without Bricks; a standalone top-level menu appears, and Bricks-only sections hide on non-Bricks sites.
1.4.6 / 1.4.7-alpha

Added

  • Selective push to remote and selective workflow runs, sync only the items you choose.
  • Scope-choice dialog to pick selected vs. all items before running a workflow.
  • Builder Panel to manage workflow-on-save from inside Bricks.
  • Bricks capability settings (SVG uploads, code execution, maintenance bypass) included in sync.

Fixed

  • Media imports reconnect to existing files instead of creating duplicates.
  • Custom fonts, CSS variables, and cross-site references sync far more reliably.
  • Fixed empty template/header/footer imports and preserved backslashes in code elements.
  • Incomplete workflows warn and block running until finished; large media pushes are more reliable on strict hosts.
1.4.0–1.4.5-alpha

Added

  • Workflow notifications (email/webhook) and configurable multi-step workflows.
  • Template versioning & rollback, and a conflict-resolution UI for imports.
  • Audit trail and compliance logging; maintenance-mode integration; template dependency detection.
  • Bundles, WordPress Widgets sync, and expanded Global Styles management.
  • Batch and scheduled sync tools, including network batch tabs and API endpoints.

Fixed

  • Remote pulls import template content correctly and reliably overwrite existing templates.
  • Editing a workflow updates it instead of creating a duplicate.

Changed

  • Minimum PHP raised to 8.0; simpler multisite UI and batch management.
1.3-alpha series

Added

  • Full localization support and a comprehensive in-app Guides system.
  • Integration status system with visibility toggles and a dashboard widget.
  • Site Role setting (receiver/source) for remote sync; expanded WP-CLI config.

Fixed

  • Pull mode, webhook, and cron stability improvements.

Changed

  • Optional debug logging; improved admin permission checks.

Removed

  • Legacy Parent/Child connection system.
1.2-alpha

Added

  • Components as a first-class sync type, with name-based identity for cross-site matching.
  • Component and template manifests for tracking and integrity.

Changed

  • Better overwrite and batch import controls.
1.0.0–1.1.1

Added

  • Official 1.0 release; better support for Bricks Components in settings export.

Fixed

  • Empty-slug template exports are skipped; auto-export respects inherited multisite sync mode.
0.8.0-alpha

Added

  • Full WordPress multisite and network-admin support.
  • Site-level overrides, group-based configuration, and a Sites & Effective Configuration overview.

Changed

  • Better multisite UI, accessibility, and security checks.
0.1.0–0.7.0

Added

  • Initial releases: manual Bricks settings and template export/import.
  • Configurable storage locations, including custom JSON paths outside the web root.
  • Automatic and scheduled sync modes; WP-CLI export/import; licensing; .htaccess protection for JSON storage.