> For the complete documentation index, see [llms.txt](https://docs.whalesync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whalesync.com/connectors/wordpress.org.md).

# WordPress.org

Two-way sync WordPress posts, pages, custom posts, categories, and tags with Airtable, Notion, Google Sheets, and more. Covers versions, hosts, and fields.

## Supported Versions

Whalesync requires Wordpress version **5.6** or greater.

### Supported Hosting Platforms

Whalesync has been tested against the following Wordpress hosting platforms:

* [WP Engine](https://wpengine.com/)
* [BlueHost](https://www.bluehost.com/)

## Recommended Settings

* We recommend that the user you generate the Application Password from for Whalesync has the role "Administrator". The minimum required role is "Editor".
* We recommend making sure your Wordpress Permalinks are not set to "Plain":

![](https://docs.whalesync.com/_astro/Screenshot%202025-08-15%20at%201.20.51%E2%80%AFPM.DkbmZ7hR_ZufEC0.webp)

## Supported Types

<table><thead><tr><th>Field</th><th>Status</th></tr></thead><tbody><tr><td>Posts</td><td>✅ Supported</td></tr><tr><td>Custom Posts</td><td>✅ Supported</td></tr><tr><td>Pages</td><td>✅ Supported</td></tr><tr><td>Categories</td><td>✅ Supported</td></tr><tr><td>Media</td><td>✖️ Not Yet</td></tr><tr><td>Tags</td><td>✅ Supported</td></tr><tr><td>Users</td><td>✖️ Not Yet</td></tr></tbody></table>

The Media table can't be mapped, but images you sync into Featured Media and image fields upload to your WordPress Media Library automatically. See [How to sync images](https://docs.whalesync.com/connectors/wordpress.org/how-to-sync-images.md) and [Supporting tables](https://docs.whalesync.com/connectors/wordpress.org/supporting-tables.md).

## Supported Fields

<table><thead><tr><th>Field</th><th>Status</th></tr></thead><tbody><tr><td>🔽 Categories</td><td>✅ Supported</td></tr><tr><td>☑️ Content</td><td>✅ Supported</td></tr><tr><td>🗃️ Custom Fields</td><td>✅ Supported</td></tr><tr><td>📂 Excerpt</td><td>✅ Supported</td></tr><tr><td><a href="https://emojipedia.org/framed-picture">🖼️</a> Featured Media</td><td>✅ Supported</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f5c3">🗃️</span> Format</td><td>✅ Supported</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> Link</td><td>✅ Supported</td></tr><tr><td>🕠 Published Date</td><td>✅ Supported</td></tr><tr><td><a href="https://emojipedia.org/link">🔗</a> Slug</td><td>✅ Supported</td></tr><tr><td>🗃️ Status</td><td>✅ Supported</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f51d">🔝</span> Sticky</td><td>✅ Supported</td></tr><tr><td><a href="https://emojipedia.org/label">🏷️</a> Tag</td><td>✅ Supported</td></tr><tr><td>📄 Title</td><td>✅ Supported</td></tr><tr><td>🫂 Author</td><td>✖️ Not Yet</td></tr></tbody></table>

## Supported Blocks for Content

<table><thead><tr><th>Block</th><th>Status</th></tr></thead><tbody><tr><td>🎧 Audio</td><td>✅ Supported</td></tr><tr><td>📍 Bullet List</td><td>✅ Supported</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="2328">⌨️</span> Code</td><td>✅ Supported</td></tr><tr><td><a href="https://emojipedia.org/framed-picture">🖼️</a> Gallery</td><td>✅ Supported</td></tr><tr><td>📄 Heading (1-6)</td><td>✅ Supported</td></tr><tr><td><a href="https://emojipedia.org/framed-picture">🖼️</a> Image</td><td>✅ Supported</td></tr><tr><td>📂 Media &#x26; Text</td><td>✅ Supported</td></tr><tr><td>#️⃣ Numbered List</td><td>✅ Supported</td></tr><tr><td>💬 Quote</td><td>✅ Supported</td></tr><tr><td>📄 Verse</td><td>✅ Supported</td></tr><tr><td>📹 Video</td><td>✅ Supported</td></tr><tr><td>🏛️ Classic</td><td>✖️ Not Yet</td></tr><tr><td><a href="https://emojipedia.org/framed-picture">🖼️</a> Cover</td><td>✖️ Not Yet</td></tr><tr><td>📂 File</td><td>✖️ Not Yet</td></tr><tr><td>⏩ Preformatted</td><td>✖️ Not Yet</td></tr><tr><td>💬 Pullquote</td><td>✖️ Not Yet</td></tr><tr><td>📑 Table</td><td>✖️ Not Yet</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f3b9">🎹</span> Shortcode</td><td>✖️ Not Yet</td></tr></tbody></table>

## WordPress Multisite

Whalesync supports WordPress Multisite installations. Each site in your network is treated as its own independent instance, so **you need to create one base per site** you want to sync.

The URL you provide when connecting determines which site Whalesync will sync with:

| Site | URL Example |
|------|-------------|
| Main site | `https://whalesync-wp.com/` |
| Subsite | `https://whalesync-wp.com/sub-site-1/` |

If you want to sync multiple sites in your network, create a separate base for each one using the appropriate URL.

## Things to keep in mind

> [!NOTE]
> Whalesync works with WordPress version 5.6 and above

> [!NOTE]
> We recommend using a backup/restore plugin if connecting WordPress to a 2-way sync tool like Whalesync :point\_down:

[How to restore WordPress from a backup](https://wordpress.com/support/restore/)
