Testing Your Online Store Connection
Before your online store can share inventory with your website, TORO has to be able to talk to that website. The Test Tool is where you prove that connection works — it uploads a real image and a real product to your WooCommerce site and hands you back the live links, so you know the pipe is open before you go live. It's also the fastest way for TORO support to spot what's wrong when something isn't syncing.
Where to find it
Open the Online Store Module from your dashboard. If the online store isn't licensed on your store yet, you'll land on a screen offering the online store — click Test the Integration (Option 2). That opens the Test Tool.
The tool remembers everything you type, so you only fill it in once. Come back later and it's all still there.
What you'll need first
TORO connects to your website through WooCommerce, which runs on WordPress. To make that connection you need four things from the website side. Don't worry — the tool has a "?" button next to the tricky ones that walks you through getting each.
Your website address. Enter it as the bare domain with a trailing slash — no http://, no https://, no www., and nothing in front of the domain. For example: grapevinecigarshop.com/, not /grapevinecigarshop.com/. That stray slash at the front is an easy one to leave behind when you paste, and it's worth a second look: it can let the picture test pass while the product test fails. The tool will stop you and explain if the format's off.
A WordPress username. The admin login for your WordPress site.
A WordPress Application Password. This is the part that trips everyone up: it is not your normal login password. WordPress lets you create a separate "Application Password" just for connections like this one. In WordPress, go to Users → Profile → Application Passwords, create one, and copy it. It comes as six little four-character chunks (like abcd efgh ijkl mnop qrst uvwx) — paste the whole thing, spaces and all. Click the "?" next to the field and TORO will even offer to open the right WordPress page for you.
A WooCommerce API key and secret. In WordPress, go to WooCommerce → Settings → Advanced → REST API → Add key, set the permissions to Read/Write, and save. WooCommerce gives you a consumer key and a consumer secret — copy both into TORO. Again, the "?" button next to those fields lays out the steps and can open the keys page for you.
Running the tests
The tool runs two quick tests. Pick a test image and a test item first (the Choose... buttons — one opens a file picker for the image, the other opens the normal Find Item screen so you can grab a real product), then:
Run Image Upload Test. TORO uploads your image to the website's media library. If it works, the image opens in your browser automatically and the Open Image URL button lights up so you can pull it back up anytime.
Run Item Upload Test. TORO publishes the test item to your WooCommerce store as a real product, then waits for the website to hand back the product's public link. When it succeeds, that product page opens in your browser and Open Product URL becomes available.
Each test shows a spinner while it works ("Uploading image...", "Syncing product...") and writes the result into the log at the bottom. Green results mean the connection is solid.
Just checking the connection
If all you want to know is "can TORO reach my website?", use Test Connection. It checks your WordPress and WooCommerce credentials without uploading anything — no test image, no test product, nothing added to your site. The log tells you whether each side connected, and if one didn't, exactly which credential to fix.
Turning your test into a live store
Once you're licensed for the online store and your Test Connection succeeds, a Convert to Live Store button lights up. Click it and TORO turns the credentials you just verified into a real store site — no re-typing everything on another screen. After that, head to Advanced Settings on the Online Store screen to set up your item rules (which products go online, and how). If you ever need this tool again once you're live, you'll find it under Online Store → Advanced Settings → Test Connection Tool.
When a test fails
A failed test won't just say "something went wrong." TORO reads the exact reason back from your website and puts a plain-English recommendation right in the results log — the kind of thing you (or your web person) can act on. A few common ones:
- "Use an Application Password" — you probably pasted your normal login password instead of a WordPress Application Password. Go back and create the Application Password as described above.
- Image too large — rare now. TORO shrinks a picture down before it sends it, so this only comes up when your website caps uploads unusually low. The fix is a WordPress/hosting setting, and the log tells you which one.
- Can't reach the site — usually the web address is wrong, the site is down, or (for a brand-new site) the domain hasn't finished going live yet. Try opening the site in a browser first.
Handing it off to support
If you'd rather have TORO support set this up or take a look, the bottom of the tool makes that easy.
Copy — the small button beside the word Results — copies everything in the results box. When a test fails, that log is the single most useful thing you can send us, so click Copy and paste it straight into your message.
Copy Credentials puts all your connection details — plus the item name, the product link, and the sync IDs from your last test — onto your clipboard as clean, labeled text. Paste that into an email or message to support and they have everything they need.
Paste Credentials does the reverse: if support sends you a set of connection details, click this, paste them in, and click Load. TORO fills in the fields for you. (One thing to know: the item to test is specific to your own register, so if the pasted details came from another store, use Choose... to pick a local item before running the item test — the log will remind you.)