Quick Start (5 minutes)
The shortest path from "plugin not installed" to "products flowing both ways". Use this for an evaluation or a sandbox. For a real go-live, follow First-Time Setup afterwards.
What you'll have at the end
- A connected UnoPim instance
- One channel mapped to your store
- The standard product fields (SKU, name, price, stock, description) wired up
- A first full pull running in the background
- WooCommerce edits pushing back to UnoPim automatically
Before you begin
Have these four things ready:
| You'll need | Where to find it |
|---|---|
| UnoPim address | The web address of your UnoPim admin — for example https://pim.example.com |
| API client ID | Inside UnoPim, in the API clients panel |
| API client secret | Same panel — treat it like a password |
| An UnoPim admin username and password | Any UnoPim user that's allowed to use the API |
Don't have them? Ask your UnoPim admin, or check the UnoPim docs.
Step 1 — Install and activate (1 min)
In WordPress admin, open Plugins → Add New → Upload Plugin, choose the connector ZIP, click Install Now, then Activate.
A new menu UnoPim Configuration appears in the WordPress admin sidebar. For more options, see Installation.
Step 2 — Paste your credentials (1 min)
- Click UnoPim Configuration.
- Fill in your UnoPim address, client ID, client secret, and admin username and password.
- Click Test & Save.
A green Connected badge replaces the red one once your credentials check out.
Got an error? See Troubleshooting → Connection errors.
Step 3 — Pull your channels (30 seconds)
- Click the Channels & Stores tab.
- Click Refresh channels.
Your UnoPim channels appear, each with their available languages and currencies. The default channel is auto-mapped to your store.
Multisite users
You'll see a Site dropdown next to each channel. Pick which WordPress site each UnoPim channel should sync to. See Multisite.
Step 4 — Apply default mappings (30 seconds)
- Click the Field Mapping tab, then the Core Fields sub-tab.
- Click Apply WC defaults at the top.
This wires up the standard product fields:
| WooCommerce field | UnoPim attribute |
|---|---|
| SKU | sku |
| Name | name |
| Regular Price | price |
| Sale Price | special_price |
| Stock Quantity | stock |
| Description | description |
| Short Description | short_description |
Click Save mapping at the bottom.
Step 5 — Run a full pull (1 min to start)
- Click the Sync tab.
- Click Pull Full.
The connector imports — in order — your channels, languages, currencies, families, attributes, attribute options, categories, products, variants, related products, reference entities and images.
Watch progress on UnoPim Configuration → Logs. A 1,000-product catalogue typically takes 5–15 minutes.
Step 6 — Try a push (1 min)
- Open any product (Products → All Products → Edit).
- Change the price and save.
- Switch to UnoPim, reload the same product.
The new price should appear within a few seconds.
If it didn't, check the Logs page. The most common causes are:
- Push is turned off for this channel — open Channels & Stores and toggle Push enabled on.
- You just pulled this product and the connector is in its short cooldown — wait a minute and try again.
- No default family is set — fix it on the Core Fields tab.
You're live. What next?
| If you want to… | Read |
|---|---|
| Map your custom attributes (size, colour, brand…) | Attribute Mapping |
| Map your category tree to UnoPim | Category Mapping |
| Set up automatic recurring syncs | Scheduled Jobs |
| Preview a sync before it writes anything | Dry Run |
Going to production?
Read First-Time Setup end-to-end before pointing this at a live store. The five-minute version skips a few safety checks — a dry-run preview, a per-channel cooldown tune-up — that matter once real customers are involved.
