UnoPim ConnectorUnoPim Connector
View Demo
  • Getting Started

    • Introduction
    • Quick Start
    • Features
    • Installation
    • First-Time Setup
    • Onboarding Path
  • Configuration

    • Connection
    • Channels & Stores
    • Settings Overview
    • General Settings
  • Mapping

    • Mapping Overview
    • Core Fields
    • Attributes
    • Categories
  • Sync & Operations

    • Sync Page
    • Scheduled Jobs
    • Logs
    • Pull Pipeline
    • Push Pipeline
    • Variants
  • Compatibility

    • Multisite
    • Multilingual (WPML)
    • HPOS
  • Help

    • Troubleshooting
    • FAQ
    • Glossary
Support
View Demo
  • Getting Started

    • Introduction
    • Quick Start
    • Features
    • Installation
    • First-Time Setup
    • Onboarding Path
  • Configuration

    • Connection
    • Channels & Stores
    • Settings Overview
    • General Settings
  • Mapping

    • Mapping Overview
    • Core Fields
    • Attributes
    • Categories
  • Sync & Operations

    • Sync Page
    • Scheduled Jobs
    • Logs
    • Pull Pipeline
    • Push Pipeline
    • Variants
  • Compatibility

    • Multisite
    • Multilingual (WPML)
    • HPOS
  • Help

    • Troubleshooting
    • FAQ
    • Glossary
Support
  • Getting Started

    • Introduction
    • Quick Start
    • Features
    • Installation
    • First-Time Setup
    • Onboarding Path
  • Configuration

    • Connection
    • Channels & Stores
    • Settings Overview
    • General Settings
  • Mapping

    • Field Mapping (Overview)
    • Core Fields Mapping
    • Attribute Mapping
    • Category Mapping
  • Sync & Operations

    • Sync
    • Scheduled Jobs
    • Logs
    • Pull (UnoPim → WooCommerce)
    • Push (WooCommerce → UnoPim)
    • Variants
  • Compatibility

    • Multisite
    • Multilingual (WPML)
    • HPOS Compatibility
  • Help

    • Troubleshooting
    • FAQ
    • Glossary

Installation

Three ways to install. Pick whichever you're comfortable with.

What your site needs

WhatMinimumRecommended
WordPress6.4Latest stable (6.8+)
WooCommerce8.09.x
PHP8.18.2
MySQL / MariaDB5.7 / 10.48.0 / 10.6
HTTPSIf your UnoPim is on HTTPS (recommended)TLS 1.2+

Not sure if your site meets the requirements?

Open Tools → Site Health → Info in your WordPress admin. The PHP and database versions are listed there. If anything is below the minimum, ask your host to upgrade — most managed WooCommerce hosts will do this for free.

What you'll need before you start

  • A working UnoPim instance — note its web address
  • An UnoPim API client ID and client secret
  • An UnoPim admin username and password
  • A WordPress login as an administrator or shop manager

Method 1 — Upload through the WordPress admin (recommended)

  1. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
  2. Click Choose File and pick the connector ZIP.
  3. Click Install Now.
  4. Click Activate Plugin.

A new menu UnoPim Configuration appears in the WordPress admin sidebar.

Method 2 — FTP or SFTP

  1. Unzip the connector on your computer.
  2. Upload the resulting unopim-connector folder to your site's wp-content/plugins/ directory.
  3. In WordPress admin, open Plugins → Installed Plugins.
  4. Find UnoPim Connector and click Activate.

Method 3 — Hand the file to your developer

If your site is locked down or managed by an agency, send them the ZIP and ask them to install and activate it. They won't need any extra information from you.

What activation does

When you activate the connector for the first time, it sets itself up automatically:

  • Creates the tables it needs to track your synced data
  • Seeds safe defaults (dry-run is off, deletes go to trash, automatic sync is hourly)
  • Tells WooCommerce it's compatible with the new high-performance order storage and block-based checkout

It does not contact UnoPim, change your products, or alter any of your existing data. You can safely activate first and configure later.

Quick check after activation

Open UnoPim Configuration in your WordPress admin sidebar. You should see:

  • The Connection form with empty fields
  • A red Not connected badge at the top of the page
  • A second tab, Channels & Stores (it'll be empty until you save valid credentials)

If the menu doesn't appear, your user account doesn't have the right permissions. Sign in as an administrator or shop manager.

Updating the plugin

When a new version is available:

  1. Back up your site (your host usually has a one-click option).
  2. Replace the plugin folder, or upload the new ZIP and overwrite.
  3. Visit any WordPress admin page — the connector finishes its update automatically.

The connector never destroys data on update. Schema changes are additive.

Deactivating versus deleting

ActionWhat's keptWhat's removed
DeactivateEverything — tables, mappings, logsThe connector stops running, and scheduled syncs pause
Delete (default)EverythingJust the plugin code
Delete with "Remove data on uninstall" turned onNothingTables, mappings, logs — fully scrubbed

The "remove data on uninstall" toggle lives in General Settings. Leave it off unless you really mean it.

Multisite

If you run a WordPress network, you can either network-activate the connector (it sets itself up on every site) or activate it per site. The channel-to-site mapping happens later, on the Channels & Stores tab. See Multisite.

Troubleshooting installation

SymptomLikely causeFix
"Plugin could not be activated…"Your site is on an older PHP versionAsk your host to upgrade to PHP 8.1 or newer
Activation worked but no menu appearsYour account doesn't have the right permissionsSign in as an administrator or shop manager
Activation worked but the Connection tab errorsWooCommerce isn't activated, or your site is missing standard security keysActivate WooCommerce; ask your developer to add WordPress secret keys to wp-config.php

More fixes in Troubleshooting.


Next: Connection

Prev
Features
Next
First-Time Setup