WordPress
Use this page to set up the WordPress source connector and find reference information.
Prerequisites
- A self-hosted WordPress site (WordPress.org) with the REST API enabled. It’s enabled by default on WordPress 4.7 and later.
- Your site’s domain name, for example,
my-site.example.com.
:::note This connector reads data from the public WordPress REST API. You can access most read endpoints without authentication. These include posts, pages, comments, categories, tags, and media. Endpoints exposing private data require authentication. These include plugins, themes, settings, and full user details. :::
Authentication
The connector sends HTTP Basic Authentication headers with every request. For public endpoints, leave the Username and Password fields at their default values.
To access authenticated endpoints, including plugins, themes, and settings, provide valid WordPress credentials. WordPress recommends Application Passwords for REST API authentication. They’re available from WordPress 5.6.
- In your WordPress admin dashboard, go to Users > Profile.
- Scroll to the Application Passwords section.
- Enter an application name, for example,
Airbyte, then click Add New Application Password. - Copy the generated password. Use your WordPress username and this application password as the connector credentials.
Set up
- Enter your WordPress site’s Domain without the protocol, for example,
my-site.example.com. - Enter your Username and Password. Keep the default values if you only need to sync public data.
- Optionally, set a Start Date. This limits incremental streams to records modified after that date. Use the format
YYYY-MM-DDTHH:MM:SSZ, for example,2024-01-01T00:00:00Z. - Optionally, set a Lookback Window in hours for incremental streams. Each sync re-fetches that many hours of previously synced data to prevent data loss. Set it to
0to disable this setting. Destination deduplication handles duplicates.
Supported sync modes
The WordPress source connector supports these sync modes:
- Full Refresh
- Incremental
Supported streams
The connector syncs data from these WordPress REST API endpoints:
| Stream | API Endpoint | Sync Mode | Pagination | Primary Key | Description |
|---|---|---|---|---|---|
| users | /wp/v2/users | Full Refresh | Yes | id | Site authors and contributors. |
| posts | /wp/v2/posts | Full Refresh | Yes | id | Blog posts. |
| categories | /wp/v2/categories | Full Refresh | Yes | id | Post categories. |
| tags | /wp/v2/tags | Full Refresh | Yes | id | Post tags. |
| pages | /wp/v2/pages | Incremental | Yes | id | Static pages. Cursor field: modified. |
| page_revisions | /wp/v2/pages/{id}/revisions | Full Refresh | Yes | id | Revision history for each page. |
| comments | /wp/v2/comments | Incremental | Yes | id | Comments on posts and pages. Cursor field: date. |
| media | /wp/v2/media | Incremental | Yes | id | Uploaded images, videos, and other media files. Cursor field: modified. |
| editor_blocks | /wp/v2/blocks | Incremental | Yes | id | Reusable block patterns (synced patterns). Cursor field: modified. |
| plugins | /wp/v2/plugins | Full Refresh | No | plugin | Installed plugins. Requires authentication. |
| taxonomies | /wp/v2/taxonomies | Full Refresh | No | category | Registered taxonomies (for example, categories and tags). |
| types | /wp/v2/types | Full Refresh | No | — | Registered post types (for example, post, page, attachment). |
| themes | /wp/v2/themes | Full Refresh | No | stylesheet | Installed themes. Requires authentication. |
| statuses | /wp/v2/statuses | Full Refresh | No | — | Available post statuses (for example, publish, draft, private). |
| settings | /wp/v2/settings | Full Refresh | No | — | Site-wide settings such as title, description, and timezone. Requires authentication. |
Incremental sync
The pages, media, and editor_blocks streams use the modified field as their cursor. This tracks records by their last modification time in the site’s local timezone. The comments stream uses the date field.
These timestamps use the site’s local timezone. Clock changes during daylight saving time (DST) transitions can therefore cause non-monotonic timestamps. If this concerns you, configure a Lookback Window to re-fetch recent data and prevent gaps.
Limitations
- Pagination: The WordPress REST API limits paginated responses to 100 items per page. The connector handles this automatically.
- Authenticated endpoints: The
plugins,themes, andsettingsstreams require valid credentials. Without authentication, these streams return errors or empty results. - WordPress.com hosted sites: This connector supports the self-hosted WordPress REST API (
/wp-json/wp/v2/). It may not work with WordPress.com sites, which use a different API structure.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.0.72 | 2026-11-10 | 91777 | Update dependencies |
| 0.0.71 | 2026-11-03 | 90819 | Update dependencies |
| 0.0.70 | 2026-10-27 | 90072 | Update dependencies |
| 0.0.69 | 2026-10-20 | 89460 | Update dependencies |
| 0.0.68 | 2026-10-13 | 88873 | Update dependencies |
| 0.0.67 | 2026-10-06 | 88109 | Update dependencies |
| 0.0.66 | 2026-09-29 | 87423 | Update dependencies |
| 0.0.65 | 2026-09-22 | 86896 | Update dependencies |
| 0.0.64 | 2026-09-15 | 86286 | Update dependencies |
| 0.0.63 | 2026-09-08 | 85725 | Update dependencies |
| 0.0.62 | 2026-08-18 | 84832 | Update dependencies |
| 0.0.61 | 2026-08-11 | 84186 | Update dependencies |
| 0.0.60 | 2026-08-04 | 83677 | Update dependencies |
| 0.0.59 | 2026-07-28 | 83155 | Update dependencies |
| 0.0.58 | 2026-07-21 | 82673 | Update dependencies |
| 0.0.57 | 2026-07-14 | 82079 | Update dependencies |
| 0.0.56 | 2026-06-30 | 81328 | Update dependencies |
| 0.0.55 | 2026-06-23 | 80728 | Update dependencies |
| 0.0.54 | 2026-06-16 | 80120 | Update dependencies |
| 0.0.53 | 2026-06-09 | 79563 | Update dependencies |
| 0.0.52 | 2026-06-02 | 79064 | Update dependencies |
| 0.0.51 | 2026-04-28 | 77478 | Update dependencies |
| 0.0.49 | 2026-04-09 | 76063 | Add configurable lookback window to incremental streams to prevent data loss; fix tab character in pages stream request parameter |
| Version | Date | Pull Request | Subject |
| ------- | ---------- | ------------ | ------------------------------------------------------------------------------------- |
| 0.0.50 | 2026-04-21 | 76792 | Update dependencies |
| 0.0.49 | 2026-04-03 | 76063 | Add 1-hour lookback window to incremental streams to prevent data loss during DST transitions; fix tab character in pages stream request parameter |
| 0.0.48 | 2026-03-31 | 75861 | Update dependencies |
| 0.0.47 | 2026-03-24 | 74691 | Update dependencies |
| 0.0.46 | 2026-03-03 | 74149 | Update dependencies |
| 0.0.45 | 2026-02-17 | 73511 | Update dependencies |
| 0.0.44 | 2026-01-27 | 72050 | Update dependencies |
| 0.0.43 | 2026-01-14 | 71483 | Update dependencies |
| 0.0.42 | 2025-12-18 | 70682 | Update dependencies |
| 0.0.41 | 2025-11-25 | 70195 | Update dependencies |
| 0.0.40 | 2025-11-18 | 69649 | Update dependencies |
| 0.0.39 | 2025-10-29 | 68929 | Update dependencies |
| 0.0.38 | 2025-10-21 | 68373 | Update dependencies |
| 0.0.37 | 2025-10-14 | 67932 | Update dependencies |
| 0.0.36 | 2025-10-07 | 67324 | Update dependencies |
| 0.0.35 | 2025-09-30 | 66457 | Update dependencies |
| 0.0.34 | 2025-09-09 | 65666 | Update dependencies |
| 0.0.33 | 2025-08-24 | 65432 | Update dependencies |
| 0.0.32 | 2025-08-10 | 64860 | Update dependencies |
| 0.0.31 | 2025-08-02 | 64324 | Update dependencies |
| 0.0.30 | 2025-07-27 | 64091 | Update dependencies |
| 0.0.29 | 2025-07-19 | 63637 | Update dependencies |
| 0.0.28 | 2025-07-12 | 63192 | Update dependencies |
| 0.0.27 | 2025-07-05 | 62750 | Update dependencies |
| 0.0.26 | 2025-06-28 | 62239 | Update dependencies |
| 0.0.25 | 2025-06-21 | 61780 | Update dependencies |
| 0.0.24 | 2025-06-15 | 61196 | Update dependencies |
| 0.0.23 | 2025-05-24 | 60745 | Update dependencies |
| 0.0.22 | 2025-05-10 | 60006 | Update dependencies |
| 0.0.21 | 2025-05-04 | 59556 | Update dependencies |
| 0.0.20 | 2025-04-26 | 58946 | Update dependencies |
| 0.0.19 | 2025-04-19 | 58568 | Update dependencies |
| 0.0.18 | 2025-04-13 | 58050 | Update dependencies |
| 0.0.17 | 2025-04-05 | 57402 | Update dependencies |
| 0.0.16 | 2025-03-29 | 56901 | Update dependencies |
| 0.0.15 | 2025-03-22 | 56297 | Update dependencies |
| 0.0.14 | 2025-03-08 | 55593 | Update dependencies |
| 0.0.13 | 2025-03-01 | 55140 | Update dependencies |
| 0.0.12 | 2025-02-22 | 54494 | Update dependencies |
| 0.0.11 | 2025-02-15 | 54027 | Update dependencies |
| 0.0.10 | 2025-02-08 | 53564 | Update dependencies |
| 0.0.9 | 2025-02-01 | 53044 | Update dependencies |
| 0.0.8 | 2025-01-25 | 52424 | Update dependencies |
| 0.0.7 | 2025-01-18 | 52008 | Update dependencies |
| 0.0.6 | 2025-01-11 | 51432 | Update dependencies |
| 0.0.5 | 2024-12-28 | 50763 | Update dependencies |
| 0.0.4 | 2024-12-21 | 50361 | Update dependencies |
| 0.0.3 | 2024-12-14 | 49743 | Update dependencies |
| 0.0.2 | 2024-12-12 | 49433 | Update dependencies |
| 0.0.1 | 2024-10-21 | 46378 | Initial release by @bishalbera via Connector Builder |