WooCommerce
Set up the WooCommerce source connector and find its reference information on this page.
Prerequisites
To set up the WooCommerce source connector, you’ll need:
- WooCommerce 3.5 or later
- WordPress 4.4 or later
- Pretty permalinks enabled in Settings > Permalinks to support custom endpoints. For example,
/%year%/%monthnum%/%day%/%postname%/.
You’ll also need a WooCommerce REST API key with read permissions. Setup generates a Consumer key and Consumer secret for authentication.
Setup guide
1. Generate WooCommerce REST API keys
- In your WordPress admin panel, go to WooCommerce > Settings > Advanced > REST API.
- Click Add key.
- Enter a description and select a user with access to your store data. Set the permissions to Read.
- Click Generate API key.
- Copy the Consumer key and Consumer secret. The consumer secret appears only once.
For more information, see the WooCommerce REST API authentication documentation.
2. Set up the WooCommerce connector in Airbyte
Airbyte Cloud
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Sources. In the top-right corner, click + New source.
- Select WooCommerce from the Source type dropdown. Enter a name for the connector.
- Enter the consumer key from Step 1 in the Customer Key field. Enter the consumer secret in the Customer Secret field.
- Enter the Shop Name. For
https://EXAMPLE.com, the shop name isEXAMPLE.com. - Choose the Start Date to set when data syncing begins.
- (Optional) Adjust the Number of Concurrent Threads to control sync parallelism. The default is 5. Higher values can speed up syncs but may cause rate limiting, depending on your hosting provider. Valid range: 2-12.
Airbyte Open Source
- Go to the Airbyte Open Source dashboard.
- Click Sources, then click + New source.
- Select WooCommerce from the Source type dropdown. Enter a name for the connector.
- Enter the consumer key from Step 1 in the Customer Key field. Enter the consumer secret in the Customer Secret field.
- Enter the Shop Name. For
https://EXAMPLE.com, the shop name isEXAMPLE.com. - Choose the Start Date to set when data syncing begins.
- (Optional) Adjust the Number of Concurrent Threads to control sync parallelism. The default is 5. Higher values can speed up syncs but may cause rate limiting, depending on your hosting provider. Valid range: 2-12.
Supported sync modes
You can use the following sync modes with the WooCommerce source connector:
Supported streams
- Coupons (Incremental)
- Customers (Incremental)
- Orders (Incremental)
- Order notes
- Payment gateways
- Product attribute terms
- Product attributes
- Product categories
- Product reviews (Incremental)
- Product shipping classes
- Product tags
- Product variations
- Products (Incremental)
- Refunds
- Shipping methods
- Shipping zone locations
- Shipping zone methods
- Shipping zones
- System status tools
- Tax classes
- Tax rates
Limits and troubleshooting
Expand to see details about WooCommerce connector limitations and troubleshooting.
Connector limits
Rate limits
The WooCommerce REST API doesn’t enforce built-in rate limits. Your hosting provider sets the actual limits. Shared hosting environments typically allow 2-5 requests per second. The connector applies a default budget of 5 requests per second. It also handles HTTP 429 responses automatically.
To speed up syncs, increase the Number of Concurrent Threads setting in the connector configuration, up to 12. Your hosting environment must support the higher throughput. Reduce this value if you encounter rate-limiting errors.
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.5.59 | 2026-11-10 | 91775 | Update dependencies |
| 0.5.58 | 2026-11-03 | 90815 | Update dependencies |
| 0.5.57 | 2026-10-27 | 90086 | Update dependencies |
| 0.5.56 | 2026-10-20 | 89490 | Update dependencies |
| 0.5.55 | 2026-10-13 | 88866 | Update dependencies |
| 0.5.54 | 2026-10-06 | 88091 | Update dependencies |
| 0.5.53 | 2026-09-29 | 87432 | Update dependencies |
| 0.5.52 | 2026-09-22 | 86871 | Update dependencies |
| 0.5.51 | 2026-09-15 | 86294 | Update dependencies |
| 0.5.50 | 2026-09-08 | 85730 | Update dependencies |
| 0.5.49 | 2026-08-25 | 85030 | Skip product attributes whose WooCommerce taxonomy no longer exists instead of failing the sync |
| 0.5.48 | 2026-08-18 | 84829 | Update dependencies |
| 0.5.47 | 2026-08-11 | 84188 | Update dependencies |
| 0.5.46 | 2026-08-04 | 83676 | Update dependencies |
| 0.5.45 | 2026-07-28 | 83185 | Update dependencies |
| 0.5.44 | 2026-07-21 | 82669 | Update dependencies |
| 0.5.43 | 2026-07-14 | 82068 | Update dependencies |
| 0.5.42 | 2026-06-30 | 81312 | Update dependencies |
| 0.5.41 | 2026-06-23 | 80712 | Update dependencies |
| 0.5.40 | 2026-06-16 | 80112 | Update dependencies |
| 0.5.39 | 2026-06-09 | 79578 | Update dependencies |
| 0.5.38 | 2026-06-02 | 79058 | Update dependencies |
| 0.5.37 | 2026-04-28 | 77469 | Update dependencies |
| 0.5.36 | 2026-04-21 | 76804 | Update dependencies |
| 0.5.35 | 2026-04-14 | 76330 | Promoted release candidate to GA |
| 0.5.35-rc.2 | 2026-04-12 | 76253 | Increase default concurrency from 4 to 5 for tuning iteration 2 |
| 0.5.35-rc.1 | 2026-04-10 | 76205 | Add concurrency_level and num_workers for concurrent stream syncing |
| 0.5.34 | 2026-03-31 | 75853 | Update dependencies |
| 0.5.33 | 2026-03-24 | 75380 | Update dependencies |
| 0.5.32 | 2026-03-10 | 74674 | Update dependencies |
| 0.5.31 | 2026-02-24 | 73889 | Update dependencies |
| 0.5.30 | 2026-02-10 | 72988 | Update dependencies |
| 0.5.29 | 2026-02-06 | 72658 | Update dependencies |
| 0.5.28 | 2026-01-20 | 72054 | Update dependencies |
| 0.5.27 | 2026-01-14 | 71438 | Update dependencies |
| 0.5.26 | 2025-12-19 | 70708 | Update dependencies |
| 0.5.25 | 2025-11-25 | 70138 | Update dependencies |
| 0.5.24 | 2025-11-18 | 69676 | Update dependencies |
| 0.5.23 | 2025-11-13 | 69282 | Add client side incremental sync support for customers stream |
| 0.5.22 | 2025-10-29 | 68975 | Update dependencies |
| 0.5.21 | 2025-10-22 | 68591 | Add suggestedStreams |
| 0.5.20 | 2025-10-21 | 68393 | Update dependencies |
| 0.5.19 | 2025-10-14 | 67941 | Update dependencies |
| 0.5.18 | 2025-10-07 | 67328 | Update dependencies |
| 0.5.17 | 2025-10-01 | 66455 | Update dependencies |
| 0.5.16 | 2025-09-09 | 65708 | Update dependencies |
| 0.5.15 | 2025-08-24 | 65450 | Update dependencies |
| 0.5.14 | 2025-08-10 | 64822 | Update dependencies |
| 0.5.13 | 2025-08-02 | 64347 | Update dependencies |
| 0.5.12 | 2025-07-27 | 64087 | Update dependencies |
| 0.5.11 | 2025-07-19 | 63629 | Update dependencies |
| 0.5.10 | 2025-07-12 | 63207 | Update dependencies |
| 0.5.9 | 2025-07-05 | 62689 | Update dependencies |
| 0.5.8 | 2025-06-28 | 62259 | Update dependencies |
| 0.5.7 | 2025-06-21 | 61763 | Update dependencies |
| 0.5.6 | 2025-06-15 | 61474 | Update dependencies |
| 0.5.5 | 2025-06-04 | 51438 | Update dependencies |
| 0.5.4 | 2024-12-28 | 50800 | Update dependencies |
| 0.5.3 | 2024-12-21 | 50335 | Update dependencies |
| 0.5.2 | 2024-12-14 | 49382 | Update dependencies |
| 0.5.1 | 2024-12-11 | 47510 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.5.0 | 2024-10-16 | 46956 | Promoting release candidate 0.5.0-rc.1 to a main version. |
| 0.5.0-rc.1 | 2024-10-08 | 46575 | Migrate to Manifest-only |
| 0.4.12 | 2024-10-12 | 46806 | Update dependencies |
| 0.4.11 | 2024-10-05 | 46423 | Update dependencies |
| 0.4.10 | 2024-09-28 | 46193 | Update dependencies |
| 0.4.9 | 2024-09-21 | 45776 | Update dependencies |
| 0.4.8 | 2024-09-14 | 45534 | Update dependencies |
| 0.4.7 | 2024-09-07 | 45230 | Update dependencies |
| 0.4.6 | 2024-08-31 | 44957 | Update dependencies |
| 0.4.5 | 2024-08-24 | 44627 | Update dependencies |
| 0.4.4 | 2024-08-19 | 44388 | Update the CDK version to support RFR for Low-Code substreams |
| 0.4.3 | 2024-08-17 | 44228 | Update dependencies |
| 0.4.2 | 2024-08-12 | 43786 | Update dependencies |
| 0.4.1 | 2024-08-10 | 43487 | Update dependencies |
| 0.4.0 | 2024-08-06 | 43323 | Update CDK to v4, Python 3.10 |
| 0.3.1 | 2024-08-03 | 43054 | Update dependencies |
| 0.3.0 | 2024-07-26 | 42551 | Make builder compatible |
| 0.2.13 | 2024-07-27 | 42637 | Update dependencies |
| 0.2.12 | 2024-07-20 | 42157 | Update dependencies |
| 0.2.11 | 2024-07-13 | 41731 | Update dependencies |
| 0.2.10 | 2024-07-10 | 41581 | Update dependencies |
| 0.2.9 | 2024-07-09 | 41161 | Update dependencies |
| 0.2.8 | 2024-07-06 | 40814 | Update dependencies |
| 0.2.7 | 2024-06-25 | 40375 | Update dependencies |
| 0.2.6 | 2024-06-22 | 40094 | Update dependencies |
| 0.2.5 | 2024-06-06 | 39270 | [autopull] Upgrade base image to v1.2.2 |
| 0.2.4 | 2024-05-21 | 38544 | [autopull] base image + poetry + up_to_date |
| 0.2.3 | 2023-06-02 | 26955 | Added block_context and author properties to the Products stream |
| 0.2.2 | 2023-03-03 | 23599 | Fix pagination and removed lookback window |
| 0.2.1 | 2023-02-10 | 22821 | Specified date formatting in specification |
| 0.2.0 | 2022-11-30 | 19903 | Migrate to low-code; Certification to Beta |
| 0.1.1 | 2021-11-08 | 7499 | Remove base-python dependencies |
| 0.1.0 | 2021-09-09 | 5955 | Initial Release. Source WooCommerce |