Skip to content
English
Need more help? Submit a request Customer portal
Go to app.sprii.io
  • There are no suggestions because the search field is empty.

Set up the WooCommerce integration

Connect WooCommerce, install the Sprii plugin, and start the first product import.

Connect your webshop to the intended Sprii Page, then import its products. Shoppers complete checkout in WooCommerce, which remains responsible for product availability, payment, shipping and fulfillment.

You need administrator access to the Sprii Page and to WordPress/WooCommerce, including permission to create an API key and install a plugin. Have an active, purchasable WooCommerce product available so you can check the import.

Open the integration in Sprii

  1. Select the intended Page. Open Page settings Page settings in Sprii > E-commerce integration E-commerce integration in Sprii. This connection belongs to that Page.
  2. Find the WooCommerce card and click Configure.

    WooCommerce Configure card
  3. Click Activate webshop Activate webshop button before entering the settings. Save the completed connection later in this guide.

Create the WooCommerce key and enter it in Sprii

  1. In your WordPress administration, open WooCommerce > Settings > Advanced > REST API.
  2. Select Create an API key or Add Key. Add a description such as Sprii, select the WordPress user for the integration, and set Permissions to Read/Write. The selected user needs access to the store data the integration uses, including orders.
  3. Click Generate API Key. Keep this screen open while you copy the displayed Consumer Key and Consumer Secret into Sprii:
    • consumerKey: paste the WooCommerce Consumer Key.
    • consumerSecret: paste the WooCommerce Consumer Secret.
    • Site Url: enter your storefront address, copied from the browser address bar when you open the webshop.


    Empty Site Url, consumerKey and consumerSecret fields

    WooCommerce's API-key instructions show the provider's key-creation screen.
  4. Keep Use default checkout page selected to send shoppers directly to the WooCommerce checkout. Use default checkout page selected

Install the downloaded Sprii plugin

  1. In the open Sprii integration, click Download plugin Download plugin button. This downloads the ZIP file you will upload in the next step.
  2. In WordPress, open Plugins > Add New, then click Upload Plugin at the top of the page.
  3. Select the ZIP file you just downloaded from Sprii and click Install Now.
  4. When WordPress reports that installation succeeded, click Activate Plugin. Activating the WordPress plugin is a separate step from Activate webshop in Sprii.

WordPress's plugin installation instructions show this upload route.

Save and start the product import

  1. Return to Sprii and click Save Save button. Resolve any error or required prompt shown before continuing.
  2. In the integration settings, click Start full product import Start full product import button. Activation alone does not import the catalog; this action requests the first full import.
  3. Allow the import to finish, then check that your expected product appears in the Page's product catalog. Use products from that catalog in your campaigns.
  4. If you already have a campaign, open its Products and check its product selection, prices and inventory too. A catalog check alone does not check the values used by that campaign.

What to know before using it

Important: Opening a WooCommerce cart from Sprii clears the shopper's existing WooCommerce cart and rebuilds it from the Sprii order lines.

  • Campaign products must come from your WooCommerce catalog and remain active and purchasable there. A product created only in a Sprii campaign can fail at checkout.
  • After setup, product creates, updates, restores and deletions normally arrive through WooCommerce webhooks. There is no scheduled catalog poll to repair a missed product update. If products remain stale, check the webhook connection and run a full product import.
  • Only WooCommerce orders in Processing or Completed update Sprii. A fallback runs every 2 hours for missed qualifying order updates; it does not repair product updates.
  • An older Sprii plugin can stack an active WooCommerce discount on top of a custom Sprii price. Update the plugin before using custom campaign prices. Different prices across variants may require variant-level pricing configuration for your Sprii setup.
  • If you later use a custom checkout-page path, verify that it works with your active WordPress theme.


Need help? Contact Sprii Support