> 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

## 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":

<figure><img src="/files/nHDsgEntyauR4gRBCpxt" alt=""><figcaption></figcaption></figure>

## Supported Types

<table><thead><tr><th width="358.5">Field</th><th>Status<select><option value="6c90dea3d4b34f409e73be79b7076c4a" label="✖️ Not Yet" color="blue"></option><option value="9e01356060cc4ea4988d69f72fe19d39" label="✅ Supported" color="blue"></option><option value="bd4357bee12749d0b80f7bc4a94ec3b5" label="➡️ Supported (1-Way)" color="blue"></option><option value="9b0955a85d044258a10aa0d1d3695a79" label="✅ Supported (as JSON)" color="blue"></option><option value="3ed1eb655ce94da49e887be21197ec27" label="🔜 Coming Soon" color="blue"></option></select></th><th data-hidden></th></tr></thead><tbody><tr><td>Posts</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Custom Posts</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Pages</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Categories</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Media</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Tags</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>Users</td><td><span data-option="6c90dea3d4b34f409e73be79b7076c4a">✖️ Not Yet</span></td><td></td></tr></tbody></table>

## Supported Fields

<table><thead><tr><th width="358.5">Field</th><th>Status<select><option value="6c90dea3d4b34f409e73be79b7076c4a" label="✖️ Not Yet" color="blue"></option><option value="9e01356060cc4ea4988d69f72fe19d39" label="✅ Supported" color="blue"></option><option value="bd4357bee12749d0b80f7bc4a94ec3b5" label="➡️ Supported (1-Way)" color="blue"></option><option value="9b0955a85d044258a10aa0d1d3695a79" label="✅ Supported (as JSON)" color="blue"></option></select></th><th data-hidden></th></tr></thead><tbody><tr><td>🔽 Categories</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>☑️ Content</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>🗃️ Custom Fields</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>📂 Excerpt</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><a href="https://emojipedia.org/framed-picture/">🖼️</a> Featured Media</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f5c3">🗃️</span> Format</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f517">🔗</span> Link</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>🕠 Published Date</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><a href="https://emojipedia.org/link/">🔗</a> Slug</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>🗃️ Status</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f51d">🔝</span> Sticky</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td><a href="https://emojipedia.org/label/">🏷️</a> Tag</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>📄 Title</td><td><span data-option="9e01356060cc4ea4988d69f72fe19d39">✅ Supported</span></td><td></td></tr><tr><td>🫂 Author</td><td><span data-option="6c90dea3d4b34f409e73be79b7076c4a">✖️ Not Yet</span></td><td></td></tr></tbody></table>

## Supported Blocks for Content

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

{% hint style="info" %}
Whalesync works with WordPress version 5.6 and above
{% endhint %}

{% hint style="info" %}
We recommend using a backup/restore plugin if connecting WordPress to a 2-way sync tool like Whalesync :point\_down:
{% endhint %}

{% embed url="<https://wordpress.com/support/restore/>" %}
