Opens in a new tab
Docs/Library

Library

Everything syncable on your site, in one place: browse, export, import, and push any data type.
Updated October 2026·WPChangeSync 2.2

What the Library is

The Library is where every syncable data type on your site lives, each as its own collapsible section: WordPress posts, pages, menus, widgets, media, categories, tags, and auto-discovered custom post types and taxonomies, plus any custom data sources you define, and, when Bricks is installed, Templates, Components, Bricks Settings, and Global Styles.

Per-section actions

Every section offers the same controls:

  • Export / import a single item, a selection, or the full integration payload.
  • Push to… send selected content to a configured remote site. First you see a preview from the remote: which items would be new, which would be updated (and which fields change) and which are already the same. Untick any you want to leave out, then click Push now. The push runs in the background with a progress bar, so you can close the window. Tick Only changes since last push to send only what changed on this site since the last push to that remote. The images the items use travel with the push automatically from a local site; from a public site, tick Include media to send them along as well.
  • Run a workflow on the section, across all items, or only the ones you have checked.

Dependency preview

Before exporting post-type content, preview its dependencies so the related data travels with it. The preview counts what the item actually relies on: media (including images embedded in classic content), terms, custom fields, and parent posts.

That preview is the moment to decide how wide the release should be. Exporting a page without its media leaves broken images on the target, and exporting it without its parent can flatten it out of a page tree. When the preview shows dependencies you did not expect, that is usually a sign the change is bigger than it looked.

Selection is the unit of control

The checkboxes in any Library section drive selective export, selective push, and selective workflow runs. Check nothing and the action applies to the whole section.

Undoing a push

The receiving site records what every push changes. In Settings → Remotes, Undo last push shows what the last push to that remote changed and puts it back exactly: changed posts, pages and templates return to how they were, items the push added are removed, and custom fields, terms, translation links, settings, custom tables and replaced images are restored too.

Untick items to undo only some of them; the rest of the push stays undoable. Items edited on the remote since the push are flagged, because those edits would be lost. Undo steps back one push at a time, newest first, through the last 10 pushes.

Multilingual sites (WPML and Polylang)

On WPML and Polylang sites, each language version of a post, page, custom post type entry or Bricks template is its own item in the Library. Posts outside the default language are stored with the language in the file name, for example page-contact__en.json next to page-contact.json, so translations that share a slug never overwrite each other.

On import, every item is matched only against posts in its own language, so a Romanian page updates the Romanian page and an English page updates the English one. Existing posts are updated in place and keep their translation links. New translations are linked into the right translation group automatically, even when a translation arrives before its original. Content can also move between a WPML site and a Polylang site that use the same language codes.

By default a push only ever adds translation links. On Polylang sites you can switch on Mirror translation links from the sending site in Settings → General: the translation group of arriving content is then made to match the sender's.

The multilingual plugin must be active on both sites, with the same languages. Test connection in Settings → Remotes checks this.