Connect your WooCommerce store
Connect your WooCommerce store to bring your orders, revenue, products and customers into Trackian. Takes about 5
minutes. You'll need administrator access to your WordPress site.
Before you start
- Your store must be reachable over https:// — Trackian always calls WooCommerce over a secure connection.
- Your permalinks must be set to anything other than Plain (Settings → Permalinks in WordPress). WooCommerce's REST
API is switched off without them.
Step 1 — Open the WooCommerce REST API settings
In your WordPress admin, go to WooCommerce → Settings → Advanced → REST API, then select Add key.
On stores older than WooCommerce 3.4 this lives at WooCommerce → Settings → API → Key/Apps instead.
The REST API keys screen in WooCommerce, with the Add key button
Step 2 — Create a read-only key
1. Give the key a Description — "Trackian" is fine.
2. Leave User set to an administrator account.
3. Set Permissions to Read. Trackian only ever reads from your store, and a read key means it cannot change anything
even by accident.
4. Select Generate API key.
The Key details form with Description, User and Permissions set to Read
WooCommerce now shows your Consumer key and Consumer secret. Copy both straight away — the secret is hidden for good
once you leave this page. If you lose it, revoke the key and create a new one.
The generated Consumer key and Consumer secret
Step 3 — Start the connection in Trackian
In Trackian, go to Setup → Platforms. Under Websites, find the Woocommerce card and select Connect.
The Websites section of the Platforms page, showing the Woocommerce card
Step 4 — Paste your credentials
1. Consumer key — the value beginning ck_.
2. Consumer secret — the value beginning cs_.
3. Shop name — your domain on its own. No https://, no trailing slash, no port. For https://example.com, enter
example.com.
4. Select Add to list, then Save.
The Connect WooCommerce panel with the three fields filled in
Trackian checks the credentials against your store the moment you select Add to list, so anything mistyped is caught
right there rather than hours later.
What happens next
- Trackian finds the date of your oldest order and backfills your history from there — not just the last few weeks.
- From then on it syncs several times a day: orders, revenue, products and customers.
- The card's status moves from Not set up to Syncing to Live. Anything that goes wrong with a sync is shown on the
card itself.
- To change the credentials later, open the card → Manage, select the pencil next to your shop, edit the fields, then
select Update shop followed by Save. Select Update shop first — Save on its own won't pick up an edit you haven't
confirmed.
Troubleshooting
"Failed to connect to WooCommerce. Check your credentials." The key or secret doesn't match what's on your store, has
been revoked, or picked up a stray space when it was copied. Check it against WooCommerce → Settings → Advanced → REST
API; the list there shows the last seven characters of each key.
"Shop Name is not valid." The Shop name field has a scheme, port or path in it. It takes the bare domain and nothing
else — example.com, not https://example.com/.
"All fields are required." One of the three fields is still empty.
"Source already exists." That shop is already connected to this project.
The store works in a browser, but Trackian can't reach it. Check that your permalinks aren't set to Plain, and that a
security plugin or firewall isn't blocking requests to /wp-json/.