To read your products, nashir needs a key from your WooCommerce store. You create it yourself in your WordPress dashboard. It takes about 3 minutes and you do not need a developer.
What to know before you start:
- The key can only read. It cannot change your store, your orders or your customers.
- The key is yours. You can delete it at any time, and nashir stops reading at once.
- You must sign in to WordPress as an Administrator or a Shop manager.
- Your site must open with https (a padlock in the browser). nashir never sends your key over plain http.
- Only published products are imported. Drafts, private products and products in the trash are not.
You will copy three values into nashir: your store address, a Consumer key and a Consumer secret.
Step 1: Check your permalinks
WooCommerce can only be read from outside when your site uses "pretty" links.
- In your WordPress dashboard, open Settings, then Permalinks.
- If Plain is selected, choose Post name instead.
- Press Save Changes.
If another option than Plain is already selected, change nothing.
Step 2: Create the key
- In your WordPress dashboard, open WooCommerce, then Settings.
- Open the Advanced tab, then REST API.
- Press Add Key.
- In Description, write
nashir. - In User, leave your own user (an Administrator or a Shop manager).
- In Permissions, choose Read.
- Press Generate API Key.
Step 3: Copy the two values
WooCommerce now shows a Consumer key (it starts with ck_) and a Consumer secret (it starts with cs_).
- Copy both now. WooCommerce shows the Consumer secret only once. If you leave the page without it, create a new key.
- Treat the secret like a password: do not send it in a chat or an email.
Step 4: Connect in nashir
- Open the Stores page in nashir:
- Open WooCommerce, then fill in the Store address (for example
https://example.com), the Consumer key and the Consumer secret, and choose the business. - Press Check store. nashir shows how many products it will import and the first few as it read them. Nothing is imported yet.
- Press Connect and import. If the business already has products you added by hand, nashir shows how many will be replaced and asks you to confirm first.
After the first import, nashir reads your products again every 6 hours by itself. New products are added, prices and availability are updated, and products you deleted or unpublished are archived. To update at once, press Re-run import on the card.
What is imported
| From your store | In nashir |
|---|---|
| Published products | Imported |
| Products with options (variable products) | Imported with each option, its price and its availability |
| Regular price and sale price | Both. The sale price is used only while the sale is running in your store |
| In stock, out of stock, on backorder | Imported. "On backorder" counts as available |
| Photos, categories, the product link | Imported |
| A product with no price | Not imported |
| A grouped product | Not imported. The products inside it are imported one by one |
| A product hidden from the shop (Catalog visibility: Hidden) | Not imported |
Languages. nashir reads your products in one language: the main language of your store. Translations made with WPML or Polylang are not read. If your store returns products in several languages, the check screen says which language will be imported and how many products are left out, before you confirm.
Tax. nashir quotes the prices as you entered them in WooCommerce. If your store adds tax on top of those prices, the check screen says so.
"Coming soon" mode. If your store is still in "Coming soon" mode, nashir imports your products normally, but a customer who opens a product link sees a "coming soon" page, not the product. The check screen tells you. When you are ready, set the store to Live in WooCommerce, Settings, Site visibility.
If a security plugin or Cloudflare blocks nashir
nashir reads your store at the address /wp-json/wc/v3/ on your site. If something in front of your site stops that request, nashir tells you who stopped it when it can, and changes nothing in your catalog.
A security plugin (for example Wordfence, Solid Security, All In One WP Security). Open the plugin's settings and look for the option that restricts or disables the REST API. Allow the REST API, or at least the address /wp-json/wc/v3/. If the plugin has a firewall with a list of allowed addresses, add /wp-json/wc/v3/ to it. Then press Check store again.
Cloudflare.
- In your Cloudflare dashboard, open your site, then Security rules.
- Press Create rule, then Custom rules.
- Give the rule a name, for example
nashir. - Under When incoming requests match, choose the field URI Path, the operator starts with, and the value
/wp-json/wc/v3/. - Under Then take action, choose Skip, and tick the protections to skip.
- Press Deploy.
Two Cloudflare features cannot be skipped by a rule. If one of them is on, the request is still blocked:
- Bot Fight Mode: turn it off under Security Settings, in the Bot traffic group.
- Under Attack Mode: turn it off for your site, or use it only while you are really under attack.
Your hosting company. Some hosts run their own firewall. If nashir still cannot reach your store, send your host this sentence: "Please allow GET requests to /wp-json/wc/v3/ on my site from the application nashir (User-Agent: nashir-store-sync)."
If something goes wrong
| What nashir says | What to do |
|---|---|
| Your store did not accept this Consumer key | Copy the key again, in full. If the key was deleted, repeat step 2, with an Administrator or a Shop manager as the user. |
| The Consumer secret does not match the Consumer key | Repeat step 2 and use the two new values. |
| This key cannot read | Repeat step 2 and choose Read in Permissions. |
| The key works, but its user is not allowed to read the store settings | Create the key for an Administrator or a Shop manager. |
| Your site uses "Plain" permalinks | Do step 1. |
| A firewall or a security plugin blocked nashir | See the section above. |
| The REST API of your site is switched off | A security plugin does this. See the section above. |
| Your store answers on http only | Ask your hosting company to turn on SSL (https) for your site. |
| WooCommerce is not active | In WordPress open Plugins and check that WooCommerce is installed, active and up to date. |
| Your site does not recognise that it is opened over https | In WordPress open Settings, then General, and check that both site addresses start with https. If they do, ask your hosting company. |
| We could not reach your store | Check that your site opens in a browser, then press Retry import. |
To stop nashir reading your store, press Disconnect store on the card in nashir. To also cancel the key, open WooCommerce, Settings, Advanced, REST API and revoke the key named nashir.
If you create a new key later, press Disconnect store on the card in nashir, then connect again with the new values. Your products come back as they were.
If the sync fails, nothing in your catalog is changed or removed. After 3 failed syncs in a row, the card shows a warning and the team owner gets an email.