WooCommerce Setup Guide
Install BinHQ on your WooCommerce store and start using warehouse pick-pack workflows in under 5 minutes.
Before you start
You'll need:
- A WordPress site running WordPress 6.0 or newer
- WooCommerce 7.0 or newer installed and active
- PHP 7.4 or newer (check at Tools → Site Health → Info)
- Administrator access to your WordPress admin area
Not sure about your versions? Open your WordPress admin, go to Tools → Site Health → Info and check the WordPress, Server, and WooCommerce sections.
Step 1 — Install the plugin
Download the plugin zip from our site, then upload it through the WordPress plugin installer.
- Download binhq-for-woocommerce-latest.zip
- In your WordPress admin, go to Plugins → Add New → Upload Plugin
- Click Choose File, select the zip you just downloaded, and click Install Now
- Once installed, click Activate Plugin
You should see a new BinHQ menu item appear in your WordPress admin sidebar.
Step 2 — Connect your store
- In your WordPress admin, click BinHQ in the sidebar
- Click the Connect to BinHQ button — a new tab will open to
binhq.io - Review the permissions BinHQ will have (sync products, receive orders, adjust inventory, mark orders fulfilled)
- Sign up with your email and a strong password — or log in if you already have a BinHQ account
- Click Create account & connect
- You'll be redirected back to your WordPress admin, and the plugin settings will show Connected with a green status dot
The plugin automatically generates the WooCommerce REST API credentials BinHQ needs — you don't have to create them manually.
Step 3 — Wait for the initial sync
As soon as you connect, BinHQ starts importing your existing products and recent orders (last 90 days). This happens in the background and takes a few minutes for most stores.
How long does it take?
- Under 100 products / 50 orders: 1–2 minutes
- 100–1,000 products: 5–15 minutes
- 1,000+ products: up to 30 minutes
You can watch the progress in the plugin settings page under the Sync status section. Once it shows Complete, your store is ready to use.
Step 4 — Set up your bins
BinHQ's superpower is organizing your warehouse into named bin locations (e.g., A-12, Shelf 3, Back Room) and routing pickers to the right bin for each order line.
- Open your BinHQ dashboard
- Go to Warehouse → Bins and add a few bin names matching your physical storage
- Go to Products and assign each product (or variation) to a bin
- Your first pick list will automatically include bin locations for every line item
Step 5 — Pick, pack, fulfill
When new WooCommerce orders come in, they automatically appear in BinHQ. To fulfill them:
- Create a pick batch — Select one or more orders and batch them together
- Pick the items — BinHQ generates an optimized pick list sorted by bin location, so you walk your warehouse once instead of zigzagging
- Pack the orders — Scan barcodes or check off items to confirm each order is correctly packed
- Complete the batch — BinHQ marks the orders as Completed in WooCommerce, triggers customer shipping notifications, and adjusts your stock levels automatically
Frequently asked questions
Does BinHQ store all my order data?
Only order references + line item details needed for pick lists. Orders themselves stay in WooCommerce — BinHQ fetches them on-demand when you create a batch. Product metadata (names, SKUs, images) is cached for fast display. See our privacy policy for details.
What if my site goes down or I uninstall the plugin?
BinHQ keeps a fallback sync path using WooCommerce's REST API, so even if the plugin stops pushing events, orders still flow into BinHQ within 2 minutes. If you uninstall the plugin, you can reinstall and reconnect — no data is lost on either side.
Do I need to generate API keys manually?
No. The plugin creates WooCommerce REST API keys for you during the connection handshake. You'll see them in WooCommerce → Settings → Advanced → REST API as “BinHQ Fallback Sync”. Don't delete them unless you're disconnecting.
How does billing work for WooCommerce merchants?
WooCommerce merchants are billed directly by BinHQ via Stripe (14-day free trial on all paid plans). You can manage your subscription, update your card, and download invoices from BinHQ Dashboard → Settings → Billing. Shopify merchants use Shopify's managed pricing instead.
My store uses HPOS (High-Performance Order Storage). Is that supported?
Yes. The plugin is HPOS-compatible — it declares support in the plugin header and uses the modern WooCommerce order APIs everywhere.
Can I use this alongside Shipment Tracking / Advanced Shipment Tracking / other WC plugins?
Yes. When BinHQ marks an order as fulfilled, it writes tracking info to the same order meta fields used by popular tracking plugins (_tracking_number, _tracking_provider, _tracking_url). Those plugins will pick up the tracking automatically.
How do I uninstall?
First, disconnect from BinHQ in the plugin settings (click Disconnect). Then go to WordPress → Plugins, deactivate and delete the plugin. Finally, log into your BinHQ dashboard and remove the associated store from Settings → Stores.
Troubleshooting
The “Connect to BinHQ” button does nothing
Your browser may be blocking pop-ups. Check for a pop-up warning near your address bar and allow pop-ups for your WordPress site. Then click the button again.
Orders aren't appearing in BinHQ
Check the plugin settings page for the Last heartbeat indicator. If it's red or yellow, your site's WP cron may not be running. Set up real system cron for reliable event processing on low-traffic sites.
“Invalid handshake signature” error during connection
This usually means the plugin is outdated. Download the latest version from the link in Step 1 and reinstall. If the error persists, contact support.
Stock levels are wrong after fulfillment
BinHQ only adjusts stock for products where “Track stock quantity” is enabled in WooCommerce. If stock isn't changing, check the product's Inventory tab in WC and enable “Manage stock?”.
Need help?
We're here to help. The fastest way to reach us: