Get started listing on WooCommerce

Learn how to use the data from your products to create new WooCommerce listings, avoiding common pitfalls

Before getting started, make sure your WordPress site, your WooCommerce store, and your WooCommerce integration settings in Listing Mirror are set up correctly. WooCommerce runs on your own web server, so most connection problems come from the server setup rather than from Listing Mirror.

Before you begin

  • A WordPress site with WooCommerce installed and reachable on the public internet at its domain name. Listing Mirror won't connect to an IP address or a private or local address.
  • An administrator login for that WordPress site. You'll approve Listing Mirror's access from inside WordPress.
  • The WooCommerce REST API reachable at https://your-store.com/wp-json/wc/v3/ . In older WooCommerce versions, turn it on under WooCommerce > Settings > API by checking Enable REST API. WordPress only serves /wp-json/  addresses when Settings > Permalinks is set to anything other than Plain.
  • Your store's weight and dimension units (WooCommerce > Settings > Products). You'll need these later (see the shipping weight pitfall below).

Connect your WooCommerce store

  1. From the left menu, click Channels, followed by Connected channels.
  2. Click + Connect a new integration and select WooCommerce.
  3. In Store URL, enter your store's full address, for example https://example.com. If WordPress is installed in a subfolder, include it (for example https://example.com/shop).
  4. Click Add Credentials. You're sent to your WordPress site. Log in as an administrator if asked, and approve Listing Mirror's read/write access.
  5. WooCommerce sends you back to Listing Mirror, and the integration is created with your Store URL as its name. You can rename it with the Store Name setting.

When you connect, Listing Mirror also reads your store's weight and dimension units. Your WooCommerce categories and global product attributes are refreshed into Listing Mirror every hour.

If the connection fails

Before sending you to WordPress, Listing Mirror tests your store's REST API. These are the messages you might see and what they mean:

  • WooCommerce store version not compatible with v3 API!: the address /wp-json/wc/v3/  didn't answer normally. Check the Store URL (including any subfolder), make sure your permalinks aren't set to Plain, and make sure WooCommerce is up to date.
  • 403 Forbidden returned by API endpoint, please fix permissions.: a security plugin, firewall, or host rule is blocking the REST API. Allow access to /wp-json/ .
  • Mod_Security not allowing connection, please fix your server.: your host's Mod_Security rules are blocking the request. Ask your host to allow the WooCommerce REST API.
  • Could not connect to your WooCommerce store. Please check the Store URL.: the site couldn't be reached at that address.

Settings that matter most for your first listings

Every setting is explained in Configure WooCommerce integration settings. Before you publish, check these:

  • Update listing details: must be on for Listing Mirror to send title, description, image, and other listing changes to WooCommerce.
  • Send tracking: turn this on only if your store uses the WooCommerce Shipment Tracking plugin. Without the plugin, leave it off. Listing Mirror then marks shipments as sent without posting tracking to WooCommerce.
  • Complete sale: moves the WooCommerce order to Completed once Listing Mirror has fully shipped it.

Common Pitfall: "Invalid or duplicated SKU."

This is the most common WooCommerce error. WooCommerce requires every SKU to be unique across the entire store, counting both products and variations. If any other product or variation already uses the SKU, including one sitting in the WooCommerce Trash, WooCommerce rejects the save.

For a simple (single-SKU) product, Listing Mirror handles this automatically: it links to the existing WooCommerce product with that SKU and updates it instead of creating a duplicate. For variations, the error stays on the listing until you resolve the conflict:

  1. In WordPress, search Products (and Products > Trash) for the SKU named in the error.
  2. If it belongs to an old copy of the same item, permanently delete that copy or clear its SKU.
  3. If it's a different item, change the SKU on the Listing Mirror listing instead. WooCommerce SKUs in Listing Mirror can be up to 40 characters.
  4. Back in Listing Mirror, open the listing and click Save & Update Marketplace.

Common Pitfall: Variations on a "Simple" product

WooCommerce only allows variations on products whose type is Variable. If a listing has more than one variation but its Type is Simple, Listing Mirror shows Only type "Variable" listings can have variations. and doesn't send it.

Listing Mirror sets the type for you when it creates the listing: Variable if the product has a variation name, otherwise Simple. The error usually shows up when variations are added to a listing that was first created as a single item.

Individual Listings

  1. From the All Listings page, find the product and click its WooCommerce status to open the WooCommerce listing.
  2. Set Type to Variable. If the field isn't shown, click + Show more optional listing information.
  3. Make sure Variation Name 1 (and Variation Name 2, if used) is filled in, and every variation has a value for each.
  4. Click Save & Update Marketplace.

WooCommerce listings in Listing Mirror support up to two variation names (for example Size and Color). If a variation name matches one of your WooCommerce global attributes (Products > Attributes), Listing Mirror uses that attribute. Otherwise it creates a custom attribute on the product.


Common Pitfall: Price and sale price

Every variation needs a price. Without one, the listing shows Market Price is missing or Product Price is missing.

WooCommerce has a regular price and an optional sale price, and Listing Mirror maps them like this:

  • If Compare At Price is empty, Price is sent as the WooCommerce regular price, and any sale price is cleared.
  • If Compare At Price is filled in, it's sent as the regular price, and Price is sent as the sale price. The item shows as on sale in your store.

To end a sale, clear Compare At Price and save.


Common Pitfall: Shipping weight and dimensions in the wrong unit

Listing Mirror sends weight and dimension numbers to WooCommerce exactly as entered. They aren't converted. WooCommerce reads them in the units set on your store, so a product weighed in pounds on a store set to kilograms will show the wrong weight and get wrong shipping rates.

Individual Products

  1. From the All Listings page, find the product and click its WooCommerce status.
  2. Enter the shipping weight and dimensions in your WooCommerce store's units.
  3. Click Save & Update Marketplace.

Multiple Products Using Spreadsheets

  1. From the left menu, click Catalog, followed by Import & export.
  2. From the dropdown, select Market Listing Complete Edit, choose your WooCommerce integration (and a category if asked), and click Download Template.
  3. Once downloaded, open the sheet and enter weights and dimensions in your store's units.
  4. Save the sheet, head back to the Import & export page, and click Upload Template.

Common Pitfall: "Error getting remote image"

WooCommerce downloads each image itself from the image's web address. If your WordPress server can't fetch that address (for example, a broken link, a link with unusual characters, or a host that blocks outgoing requests), WooCommerce rejects the product with this error. Replace the image in Listing Mirror, or ask your host to allow your site to download images from outside addresses.

WooCommerce allows unlimited product images, plus one image per variation. Alt text isn't sent to WooCommerce.


Categories and other WooCommerce fields

  • Category Ids: WooCommerce's numeric category IDs. A product can be in several categories, so separate IDs with commas. In WordPress, you can find a category's ID under Products > Categories. Categories are optional for WooCommerce.
  • Status (per variation): Publish by default. Choose Draft, Pending, or Private to keep an item off your storefront.
  • Short Description: new listings start with the product's full title here. Edit it if you want different text.
  • Title: new listings are trimmed to 140 characters. Bullet points you've filled in are added to the description.

List your products to WooCommerce

Individual Listings

  1. From the All Listings page, find a product missing from WooCommerce.
  2. Click the Add to Marketplace (+) button in the WooCommerce column.
  3. Review the listing and click Publish to Marketplace.

Multiple Listings

  1. From the All Listings page, find a group of products missing from WooCommerce.
  2. On the left, click the checkbox for each listing you'd like to create.
  3. Using the dropdown, click Create, followed by WooCommerce.

Multiple Listings Using Spreadsheets

  1. From the left menu, click Catalog, followed by Import & export.
  2. From the dropdown, select Create and Delete, followed by Download Template.
  3. Once downloaded, open the sheet and enter C in the WooCommerce column on the row of each SKU you want to create.
  4. Save the sheet, head back to the Import & export page, and click Upload Template.

Orders and fulfillment

  • WooCommerce orders import automatically. Processing orders are ready to fulfill. Pending payment, On hold, and Failed orders come in as unpaid. Cancelled, Refunded, and trashed orders come in as cancelled.
  • Orders in a custom order status added by a plugin are not imported. Move them to a standard WooCommerce status if you want Listing Mirror to fulfill them.
  • With Send tracking on, Listing Mirror adds each tracking number to the order through the Shipment Tracking plugin. If you correct a tracking number later, Listing Mirror replaces the old one on the order.

Troubleshooting

The integration shows as Disabled. WooCommerce rejected Listing Mirror's keys, or your site answered with a web page instead of API data (often a security, caching, or maintenance-mode plugin). It can also happen if your site's SSL certificate is broken. Fix the site issue, then go to Channels > Connected channels and click Refresh Credentials on the WooCommerce integration to approve Listing Mirror again.

Need to view the status of your bulk template upload? Review your bulk upload history page.

Confused? Contact support!

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us