Connect your WooCommerce store
Install the Barcode Man plugin from WordPress.org, connect your site to a BarcodeMan account from WooCommerce > Barcode Man, and fix the permalink and permission blockers that stop a connection.
On this page
The Barcode Man plugin for WooCommerce is a connector. It links your WordPress site to a BarcodeMan account; designing templates, choosing products and generating label PDFs happen in the BarcodeMan workspace, which opens in its own browser tab. Nothing is embedded in your WordPress admin and the plugin adds nothing to your storefront pages.
Connecting takes a few minutes. You need to be a WordPress administrator, and you need a BarcodeMan account with a confirmed email address. The plugin is free to install and connect; Free and Pro plans are shown in BarcodeMan before you subscribe (see BarcodeMan pricing).
Before you start
- WordPress and WooCommerce. The plugin requires WordPress 5.8 or later, WooCommerce 5.0 or later, and PHP 7.4 or later. WooCommerce must be installed and active; the Barcode Man page tells you if it is not.
- Permalinks. Your site must not use Plain permalinks. WooCommerce’s store authorization does not work with them, so the Barcode Man page asks you to change them first (see If your site uses Plain permalinks below).
- Permissions. Connecting changes a site-wide setting, so it needs both site administration and WooCommerce administration permissions. A Shop Manager can use the workspace after the site is connected, but cannot connect or disconnect it.
Install the plugin
- In your WordPress admin, go to Plugins > Add New and search for Barcode Man.
- Install Barcode Man for WooCommerce and activate it. You can also download the ZIP from the WordPress.org listing and upload it under Plugins > Add New > Upload Plugin.
- Open WooCommerce > Barcode Man.
Connect the site
Connecting takes you from WordPress to BarcodeMan and back. Nothing is embedded in your WordPress admin.
- On WooCommerce > Barcode Man, read the short explanation. It names the web address where you will sign in (currently
woocommerce.barcodeman.app). Click Connect this site to Barcode Man. - This tab goes to BarcodeMan. If you open WooCommerce > Barcode Man in another tab before you finish, it shows Waiting for you to finish connecting in Barcode Man… with a Continue in Barcode Man button that takes you back to where you left off.
- In BarcodeMan, sign in, or choose Create an account. If your email address is not confirmed yet, BarcodeMan shows Confirm your email address. Open the confirmation link from your inbox, then click I have confirmed my email. Use Resend the confirmation email if it did not arrive.
- On Connect your WordPress site, check that the store URL and the account email are the ones you expect, tick I agree to the Terms of Service and Privacy Policy, and click Continue to WooCommerce.
- WooCommerce shows its own authorization screen for Barcode Man. Approve it. WooCommerce creates a REST API key for the connection and sends it straight to BarcodeMan; the plugin does not keep a copy.
- You come back to BarcodeMan on Confirm this connection. It lists the Gookit account, the WordPress site and the Site Account ID. Click Connect this site to this account.
- Your site is connected appears. Click Open the workspace, or go back to WordPress.
Back in WordPress, WooCommerce > Barcode Man now reads This site is connected to Barcode Man and shows an Open workspace button. If the page is still waiting, click I have finished — check now.
From now on, Open workspace is your way into BarcodeMan. The same Gookit account can connect more than one site; use Switch site in the workspace to move between them.
Your Site Account ID
The connected page in WordPress shows a Site Account ID. It identifies this site’s BarcodeMan account when you contact support. It is not a password and cannot be used to sign in, so quoting it in an email is safe. The workspace shows the same ID under Settings.
What the plugin stores on your site
The plugin saves an ID for the connection and a key that you can revoke at any time by disconnecting. The WooCommerce REST API key that WooCommerce creates when you approve the authorization goes directly to BarcodeMan; the plugin never stores it.
Your templates, label PDFs and plan live in your BarcodeMan account, not in WordPress. Printing never changes your products; the only write BarcodeMan makes to WooCommerce is a SKU you confirm in the SKU generator. For the full list of services involved and the data each receives, see WordPress external services.
If your site uses Plain permalinks
When the site uses Plain permalinks, the Barcode Man page explains that WooCommerce’s store authorization does not support them and does not offer the Connect button.
- As a WordPress administrator, click Switch to “Post name” permalinks for me. The page reloads and you can connect. You can also choose any structure other than Plain under Settings > Permalinks.
- A Shop Manager sees the same explanation but no button. Ask a WordPress administrator to change the permalink structure.
Changing the permalink structure can change your public URLs, so check your storefront afterwards if you had never set it before.
If you are not an administrator
Only a user with both site administration and WooCommerce administration permissions can start, cancel or remove a connection. Other users see Ask a site administrator to connect this site to Barcode Man instead of the button.
From plugin 1.2.3, while an administrator’s connection is still pending, other users do not see the link to finish it. The page tells them that a site administrator is connecting the site and to ask that person to finish. This is intentional: whoever finishes the connection decides which Gookit account controls the site’s data.
If the connection does not finish
- WooCommerce > Barcode Man still says Waiting… Reload the page, then click I have finished — check now. If it still waits, click Cancel this connection and connect again with the same Gookit account. Cancelling a connection that WooCommerce already approved revokes the REST API key that approval created, so nothing is left behind.
- This connection link has expired. Go back to WooCommerce > Barcode Man and choose Connect this site to Barcode Man again.
- This connection belongs to another account. You are signed in to BarcodeMan with a different Gookit account from the one that started the connection. Sign in with that account, or start again from WordPress.
- This store is connected somewhere else or This site account belongs to another Gookit account. The site already has a BarcodeMan site account owned by a different Gookit account. Its templates, plan and Site Account ID stay with that account. If it is yours, sign in with it and connect again. Otherwise you can connect the site as a new, empty site account, or email hi@gookit.co first if you want the existing one moved; that does not happen automatically.
- This connection could not be completed. Nothing was connected and nothing on your site changed. Try again from WordPress; if it stops a second time, contact support.
When you need to reconnect
Some situations show Connect this site to your Barcode Man account again, or a notice such as Your store URL changed. Please reconnect Barcode Man. Reconnecting with the same Gookit account renews the store keys and keeps your Site Account ID, templates and plan.
- Plugin update 1.2.2 or later on a subdirectory install. If your WordPress Address differs from your Site Address on the same domain (WordPress installed in a subfolder below the homepage), you may be asked to connect once more after updating. Templates and plan are kept.
- Store moved to a new address. Keep the plugin installed and connect again from the same site; the plugin presents its existing credential so the site keeps its Site Account ID. A site that connects from a new address without that credential receives a new Site Account ID.
- WooCommerce stopped accepting the keys. The workspace shows Barcode Man cannot reach this store. Reconnect from WooCommerce > Barcode Man, then click I have reconnected — try again in the workspace.
If an upgrade from the 2022 version of the plugin shows This site was connected to Barcode Man with an earlier version, connect it to your Gookit account; the Site Account ID, templates and plan stay exactly as they are.
Next steps
Create or check a label template under Templates in the workspace (see Choose a template type for your label paper), then follow Print product labels from WooCommerce. To remove the connection later, see Disconnect or remove BarcodeMan from WooCommerce.
Questions about this article? Email our team.
Send feedback