> 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/>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whalesync.com/connectors/wordpress.org.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
