E-commerce Product Sync

Product sync gives Grandranker a catalog of your products so generated articles can reference them. You get real names, URLs, prices and features instead of generic mentions. You add products through one or more sources: connect a store (WooCommerce, Shopify, Ecwid, BigCommerce, Shoptet), point at an XML product feed, upload a CSV, or add products by hand. You can use multiple sources at once.

How to Connect

1. Enable Product Catalog in Settings → General. You're taken to the Products page.
2. On the Products page, choose a source under "Set up your product catalog":

WooCommerce: Enter your store URL and click Connect to approve access in your WordPress admin (automatic flow). Prefer keys? Click "Connect with API keys instead" and paste a Read/Write REST API key from WooCommerce → Settings → Advanced → REST API (Consumer Key ck_… and Consumer Secret cs_…).

Shopify: Auto-sync products from your Shopify store using your Shopify connection. See Shopify.

Ecwid: In your Ecwid admin, go to Apps → My apps → develop your own app, create a custom app, then copy the Store ID and Secret Token into the connect dialog.

BigCommerce: In your control panel, go to Settings → API accounts → Create API account → Store API account with Products (read-only), Content (modify) and Information & Settings (read-only) scopes, then paste the Store Hash and Access Token.

Shoptet: In your Shoptet administration, go to Connections → Access to API, create an API access token and paste it in. Requires the Shoptet Premium tariff. The same connection powers Shoptet blog publishing.

XML feed: Paste a product feed URL from any shop platform (for example https://yourshop.com/export/products.xml). Heureka/Zboží, Google Merchant and Shoptet native export formats are recognised automatically.

CSV import: Upload a CSV (max 1MB). Required columns: name, url. Optional: description, category, price, key_features, image_url. A Download CSV template link is in the dialog, and you get a preview of the first rows before importing.

Add manually: A simple form per product. Name and URL (required), plus description, category, price, key features (up to 10), image and an Active toggle.

Publishing & Verifying

Connected stores and feeds sync automatically, and each source has a Sync Now button to refresh on demand. After connecting, check the Products page: your items should appear in the list with a source icon showing where each came from. Toggle any product's Active switch to control whether articles may reference it.

Troubleshooting

WooCommerce connection fails

If the automatic flow fails, switch to API keys: create a Read/Write key under WooCommerce → Settings → Advanced → REST API and use "Connect with API keys instead". Make sure the store URL includes https:// and points at the site root.

CSV import is rejected

Check that the file is a .csv under 1MB and includes the required name and url columns. Start from the downloadable template if unsure. The import dialog shows the exact error it hit.

Only part of my catalog shows

Large catalogs are sampled: the page may show a subset while articles search your full live catalog automatically. Shoptet is the exception. Its API has no product search, so articles can only reference the synced subset.

Shoptet source shows a re-authorization notice

The saved token stopped working (revoked or expired). Create a fresh token under Connections → Access to API and reconnect.

Questions? Contact us at [email protected].