WooCommerce

How to add a WooCommerce store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

WooCommerce is a free, ecommerce plugin for the WordPress content management system. Add ecommerce functions to your WordPress site, and expand those functions with ShipStation.

We built our extension specifically for WooCommerce. Install and configure the WooCommerce shipping plugin in a just few steps. Afterwards, you can import your WooCommerce orders directly into ShipStation, synchronize your orders, let customers choose their shipping method, include order notes, and enjoy customizable shipping-confirmation emails.

WooCommerce Requirements

Connection Requirements:

  • An active account with WooCommerce.

  • The ShipStation Integration installed in WooCommerce.

  • Your WooCommerce authentication key.

  • Your WordPress domain's Store URL.

Scope of Support

Installing the extension file to your WooCommerce environment is beyond ShipStation's scope of support. We recommend you contact your store developer or WooCommerce Support if you need assistance with the extension installation process. They can help you best, as the process may differ based on the unique configuration of the WooCommerce environment.

Order Import Requirements:

  • Include a Ship To address.

  • Include at least one physical product.

Connect a WooCommerce store to ShipStation

To connect your WooCommerce store to ShipStation.

  1. Download the ShipStation Integration plugin to your computer.

  2. Log in to your WooCommerce administrators' portal.

  3. Go to Plugins, and click on Add New.

    WooCommerce plugins menu with arrow pointing to Add New.
  4. Click Upload and select the plugin zip file from your local computer, then click Install Now.

  5. Click Activate Plugin after installation is complete.

  6. Go to the WooCommerce menu, then select Settings.

    WooCommerce menu with arrow pointing to Settings.
  7. Click Integrations.

    Note

    If you have any other Integrations connected to WooCommerce, you may also need to click ShipStation below the tab bar.

  8. Copy the Authentication Key. You can also adjust the statuses that will be exposed to ShipStation, adjust the status an order will move to when ShipStation sends a shipment update, and adjust whether logging is enabled or not. Click Save Changes when you're done.

    WooCommerce Integration tab with arrow pointing to ShipStation tab and Authentication Key section highlighted.
  9. Select the WooCommerce tile.

    WooCommerce logo.
  10. Enter your WooCommerce Authentication Key and Store URL, and map any custom statuses if needed.

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Available Features for WooCommerce Integration

ShipStation's integration with WooCommerce supports these standard features:

Common ShipStation Features

Default Status Mappings

Status

WooCommerce Status

Awaiting Payment

Pending

Awaiting Shipment

Processing

Shipped

Completed

Cancelled

Cancelled

On Hold

On-hold

Sent with Shipment Update

Field

Supported?

Status Update

Green checkmark. Supported feature. Yes.

Tracking Number

Green checkmark. Supported feature. Yes.

Carrier

Green checkmark. Supported feature. Yes.

Service

Green checkmark. Supported feature. Yes.

Carrier Fee

Green checkmark. Supported feature. Yes.

Note to Buyer

Green checkmark. Supported feature. Yes.

Item Information

Green checkmark. Supported feature. Yes.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Additional Details about the WooCommerce Integration

  • ShipStation will not receive products that are marked as Virtual or Downloadable.

  • ShipStation cannot connect to a WooCommerce store while the store is in Maintenance Mode.

  • If your WordPress site requires any extra authentication to load the page, ShipStation may be unable to connect or import orders.

    Extra authentication can include security plug-ins or features meant to block access to the site. This includes plug-ins like an age-verification screen meant to create an extra step before accessing the site. If you whitelist ShipStation in the plug-in that should allow us to bypass any additional authentication.

WooCommerce Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

Issue

How to troubleshoot or resolve

The Order Date in ShipStation is different than the Order Date in WooCommerce

This error usually occurs when the WooCommerce server uses a timezone different than the timezone set in the store's settings in ShipStation. This difference causes the Order Date to deviate when the WooCommerce server uses timezone as the basis to convert the timestamp.

Update the store's settings so the store uses the same timezone as the server that hosts your WooCommerce store.

Certain orders placed late in the day do not importing into ShipStation

Similar to the first timezone issue, this error typically occurs when the WooCommerce server uses a different timezone than the timezone set in the store's settings in ShipStation. That timezone difference causes our import process to inadvertently skip ahead.

Update the store's settings so the store uses the same timezone as the server that hosts your WooCommerce store.

"(500) Internal Server Error" when connecting a store or trying to import orders

A (500) Internal Server Error is a generic error message that essentially means something went wrong, but without any additional detail to indicate the cause of the problem.

To troubleshoot these issues, enable the WP_DEBUG option for your WordPress site. Read more about WP_DEBUG on the Debugging in WordPress page.

This setting will allow for more robust logging for WordPress, which will allow you or your site developer to find the cause of the generic error. If you're unable to resolve the issue on your own, please contact ShipStation support with the full error log and a status report. We'll help you with the next steps you should take.

Orders not importing into ShipStation after updating WooCommerce or restoring site from a backup

Sometimes, updating a WooCommerce store will cause your order database to reset and re-use Order ID values. Such resets and reuses can be problematic for ShipStation because we use Order ID values to identify unique orders. This issue is most common when you update your WooCommerce site to the latest version. The same issue can also happen if you restore the site from a backup or make other configuration changes to the store.

If only a handful of orders were effected, and the latest orders continue to import as expected, you should create manual orders to replace the absent WooCommerce orders. Then manually update WooCommerce with the shipment information.

If many orders were effected or the latest orders do not import, another solution is to create a new WooCommerce store connection in ShipStation. The new WooCommerce store connection will import the current version of the Order ID so new orders will import consistently. However, if you leave the original store connection active, you could see duplicate orders import into ShipStation. You'll want to deactivate the original store connection after you have shipped out any unresolved orders.

This integration allows you to define the Status Mappings for the store connection.

ShipStation will import the customer email address and can send customer shipment notification and delivery emails.

ShipStation will import the customer phone number.

ShipStation will import the shipping method chosen by the customer at time of checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation is able to determine if an order was placed as a gift.

ShipStation will import internal notes or order activity from the selling channel.

ShipStation will import notes left by the customer at time of checkout. Displayed as Customer notes in ShipStation's Legacy Layout.

ShipStation will import the total order weight from the selling channel.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order.

ShipStation will import item options (such as color or size) for each line item in the order.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information