Skip to main content

Connect WooCommerce

How to connect your WooCommerce account to your AgencyAnalytics dashboard.

Written by AgencyAnalytics Team

WooCommerce

WooCommerce is an open-source e-commerce plugin for WordPress. It lets you create and manage an online store with features like inventory management, secure payments, and shipping integration. Connecting WooCommerce to AgencyAnalytics allows you to pull important analytics directly from your WooCommerce store into client reports and dashboards.

  • Data is fetched every 24 hours, starting from when it is connected

  • 24 months of historical data are available

Click here to view all available WooCommerce metrics and learn what's possible.


Before You Start

To avoid a failed connection or error when connecting WooCommerce to a client, the person connecting must have:

  • API access with read permissions

  • WordPress version 4.4 or higher

  • WooCommerce version 3.5 or higher


Connect WooCommerce

Follow these steps to connect WooCommerce to a client in AgencyAnalytics:

Step 1: Open the client where you'd like to connect WooCommerce, then click the Data Sources tab at the top.

Step 2: Click the blue Connect Data Source button in the upper right corner of the page.

Step 3: Search for WooCommerce in the search bar at the top, then click the WooCommerce card.

Step 4: Enter your WooCommerce website's Store URL, API Key, and API Secret (generated from your WooCommerce plugin in WordPress), then click Save.

Once connected, you can add WooCommerce widgets to dashboards and reports, or learn to configure the prebuilt WooCommerce dashboard.


FAQ

Which URL do I use when connecting to WooCommerce?

Enter the full root domain as the Store URL, including either http:// or https:// depending on which your website uses.

Why am I seeing a "JSON: Syntax error" when connecting WooCommerce?

This error usually means the Store URL entered in the connection wizard includes a store subdirectory path rather than the root domain. The WooCommerce authenticator only accepts the root domain.

For example, enter https://www.mywebsite.com/, not https://www.mywebsite.com/store/. Update the Store URL to the root domain and try connecting again.

Why am I seeing a "cURL Error: Operation timed out" when connecting WooCommerce?

This error means the WordPress server hosting your WooCommerce store took too long to respond to AgencyAnalytics. It's a server configuration issue, not a problem with your connection credentials.

To resolve it, a developer or server admin will need to adjust the WordPress server's cURL timeout or performance settings.

Steps to fix this are usually available in your hosting provider's documentation, and you can also reference this guide to fixing a cURL timeout error in WordPress.

Which order statuses does AgencyAnalytics show for WooCommerce?

AgencyAnalytics supports the seven core (default) WooCommerce order statuses in your WooCommerce widgets:

  • Cancelled

  • Completed

  • Failed

  • On Hold

  • Pending Payment

  • Processing

  • Refunded

These statuses display in whichever language the client's report is set to under AgencyAnalytics's localization feature. If you've set up custom order statuses in WooCommerce, they can also appear in your widgets, and you can select them directly in the settings filter.

Custom statuses always appear exactly as they're named in WooCommerce, and they can't be translated by AgencyAnalytics.

Can I view historical data?

Yes, historical data is available for the past 24 months.

Why isn't my data matching what I see in WooCommerce?

This usually happens for one of a few reasons.

The timezone setting in WooCommerce may differ from the timezone selected in your client's AgencyAnalytics settings. Depending on the hour difference, orders may display on the next or previous day. To resolve this, double-check the time zone on your WooCommerce account, then update the client's time zone to match.

Another cause is how WooCommerce applies refunds in its native platform UI versus its API (which is where AgencyAnalytics fetches all WooCommerce data). In the WooCommerce native UI, refunds apply on the day they are issued, and the refund amount is deducted from that day's gross revenue. In the WooCommerce API, refunds are applied on the day the purchase was made, which can sometimes lead to discrepancies.

If you're using the "Currency Switcher" feature in WooCommerce, it changes the currency shown in the WooCommerce app's UI, but it does not change the currency in the WooCommerce API. As a result, the currency displayed in AgencyAnalytics may differ from the currency shown in the WooCommerce "Currency Switcher".


💬 Need additional help?

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄

Did this answer your question?