Quickstart

Connect your WooCommerce store

Connecting your WooCommerce store to Metorik takes just a few minutes. After connecting, Metorik will sync your store data automatically, so you can start exploring reports, segmenting customers, and tracking profit.

Before you start

Make sure your WooCommerce store meets these requirements:

  • WooCommerce installed and active — Metorik connects through the WooCommerce API.

  • WordPress REST API enabled — This is enabled by default in WordPress.

  • WooCommerce REST API enabled — This is enabled by default in WooCommerce.

Metorik does not require WooCommerce's legacy API to be enabled.

Connect your store

1

Go to the Add Store page

Navigate to app.metorik.com/add-a-store or click Add Store from your Metorik dashboard.

2

Enter your store URL

Enter just the domain — for example, if your store is at https://yourstore.com, enter yourstore.com. Don't include https:// or a trailing slash.

3

Choose a company (if applicable)

If you have multiple stores or companies set up in Metorik, select which company this store should belong to for billing purposes.

4

Click Connect

Metorik will redirect you to your WooCommerce store to log in and authorize the connection.

5

Authorize Metorik

Log in to your WordPress admin and click Approve to grant Metorik access. You'll be redirected back to Metorik once complete.

What happens next

After authorizing, Metorik begins syncing your store data automatically. This includes orders, customers, products, subscriptions, and more. You'll receive an email when the initial sync completes.

Depending on your store's size, the initial sync can take anywhere from a few minutes to several hours. Metorik syncs data in real-time going forward, so new orders and customer activity appear in your dashboard as they happen. For more details, see Data Syncing.

Troubleshooting

If you encounter issues connecting your store, try these solutions.

I see a 404 error after clicking Connect

This usually means WordPress permalinks aren't configured correctly for the API.

  1. In your WordPress admin, go to Settings → Permalinks.

  2. Select the Post name option.

  3. Click Save Changes.

  4. Try connecting your store again.

If you already have "Post name" selected and still see the error, try the URL modification solution below.

The URL has %2F after /wc-auth

After clicking Connect, if you see a 404 page with a URL containing %2F after /wc-auth, the URL encoding is causing an issue.

Fix: In your browser's address bar, replace %2F with a forward slash /.

For example, change:

https://yourstore.com/wc-auth/v1%2Flogin/?app_name=Metorik...

To:

https://yourstore.com/wc-auth/v1/login/?app_name=Metorik...

Press Enter to load the corrected URL and complete authorization.

Connect button not working — manual connection

If the automated connection fails, you can manually enter WooCommerce API keys.

  1. Go back to app.metorik.com/add-a-store.

  2. Click Connect button above not working? below the Connect button.

  3. Click add a new key here to open your WooCommerce API keys page.

  4. Create a new key with Read/Write permissions and copy the Consumer Key and Consumer Secret.

  5. Paste the keys into Metorik's form and click Save Details.

Security plugin blocking the connection

Some WordPress security plugins can block Metorik's API requests. Known plugins that may cause issues:

  • SecuPress

  • Loginizer

  • Sucuri

  • Duo Security

  • Remove WordPress Overhead

Solution: Whitelist these URL patterns in your security plugin settings:

  • wc-api/*

  • wp-json/*

Check your security plugin's documentation for how to whitelist URL patterns. If your host or security plugin requires an IP address to whitelist, contact Metorik support.

I see "This store has already been added/deleted from Metorik a couple times"

This message appears when a store URL has been repeatedly added and removed. For security reasons, you'll need to contact Metorik support to resolve this.

Click the chat icon in Metorik or email [email protected] for assistance.


For more detailed troubleshooting steps, see WooCommerce: I Can't Add My Store.

Next step: Once your store is connected, set up profit tracking to see your true costs and margins across all orders.


Previous: Getting started with Metorik

Next: Your first report

Was this helpful?