Skip to content

Shipping Tracking documentation

Add carriers and tracking numbers to your orders, show them to your customers and fix the most common problems.

Getting started

  1. Install the plugin from the Plugins screen in WordPress, or upload it to /wp-content/plugins/vanquish-shipping-tracking-for-woocommerce.
  2. Activate it. WooCommerce must be installed and active.
  3. Go to Shipping Tracking → Shipping companies and switch on the carriers you ship with. You can skip this step: until you choose, every carrier is offered.
  4. Open an order under WooCommerce → Orders. In the Shipping tracking box in the side column, pick the Carrier, type the Tracking number, add the Dispatch date if you like, and press Update.
  5. Use the Track this shipment link under the number to check the parcel.

Your customer now sees the tracking in the order emails and on their order page. Each time the tracking is added or changed, the plugin adds a private order note, timestamped by WooCommerce.

No account needed. The free version needs no account and no API key, and sends no data anywhere. It only builds links that your customer opens in their own browser.

Carriers

The plugin includes more than 1,600 carriers, most of them with their logo. For about 400 of them the link opens the parcel directly, with the tracking number already filled in. These carriers have a Direct link mark.

Choose your carriers

  1. Go to Shipping Tracking → Shipping companies.
  2. Click Add carriers to open the full catalogue. Search by name, country or slug.
  3. Switch on the carriers you use, or click Enable all results to switch on everything your search found.
  4. Optionally, pick a Default carrier. It is preselected on orders that have no tracking yet. Nothing is written to an order until you save it.

Add your own carriers

For a local courier or your own deliveries, open the Custom companies tab of Shipping Tracking → Shipping companies. Give the carrier a name and a Tracking URL template:

  • %s becomes the tracking number.
  • %post_code becomes the postcode of the order.
  • %country_code becomes the country of the order.
https://track.example.com/?code=%s&zip=%post_code&country=%country_code

Leave the URL empty for a carrier with no online tracking. The Track shipment button is then left out.

Carriers without a direct link

Most carriers only have a generic tracking page, where your customer types the number again. Under Shipping Tracking → Settings → Tracking link you can send these links to a universal tracking page, Track123 or 17TRACK, with the tracking number already filled in. Choose A universal tracking page, when the carrier has no direct link or Always a universal tracking page. A table on the same screen shows where the link of each of your carriers goes. Your custom carriers always keep the link you wrote.

Off by default. Track123 and 17TRACK are free pages of other companies, with their own brand and ads. They open in your customer's language when they offer it, in English otherwise.

What your customers see

The tracking appears in the standard WooCommerce order emails and on the order details page in My Account: the carrier logo and name, the tracking number and link, and a Track shipment button in your email colours.

Where and when

Under Shipping Tracking → Settings:

  • Show tracking on statuses: show the tracking only for these order statuses. Leave them all off to always show it.
  • Emails: Add the tracking info to WooCommerce order emails.
  • Position in emails and Position on the order page: before or after the order table, separately.

The messages

Edit the text under Shipping Tracking → Messages. There is one message for the order page and one for the emails, each with a live preview beside it. You can preview one parcel or two, at desktop or mobile width. To start, pick one of the three templates under Start from a template:. With WPML or Polylang active, there is one tab per language.

Click a placeholder to insert it:

PlaceholderBecomes
[tracking_number]The tracking number
[company_name]The carrier name
[company_icon]The carrier logo (nothing in plain-text emails)
[url_track]The tracking URL
[track_button]A Track shipment button (a plain link in plain-text emails)
[order_id]The order number
[order_url]The order page; for guest orders, the order confirmation page, which needs no login
[dispatch_date]The dispatch date

Guest customers

Guests see the tracking on the order confirmation page. You can also put the [vanstr_tracking_form] shortcode on any page: the customer enters an order number and the billing email of that order, and gets the tracking back. Failed attempts are rate limited.

[vanstr_tracking_form title="Track your order"]

Shipping services and switching plugins

ShipStation

When ShipStation for WooCommerce ships an order, its tracking is added to the order by itself. ShipStation's own tracking note is kept private, so your customer is not told twice.

Other services: REST API

Services, label tools and ERPs that send tracking to the official WooCommerce Shipment Tracking extension work unchanged. The plugin offers the same API:

/wp-json/wc/v3/orders/<id>/shipment-trackings

The wc/v1, wc/v2 and wc-shipment-tracking/v3 versions work too. A carrier the plugin does not know becomes a custom company, with the link that came with it.

The free version has one tracking per order. If a service sends a second one, it is kept on the order and you are told. Under Shipping Tracking → Settings → Trackings from shipping services you can turn off the daily summary email.

From WooCommerce Shipment Tracking

Deactivate it and activate this plugin. The tracking of each order comes across the first time the order is shown, in the admin, an email or the customer's order page. There is no bulk job to run. The extension's data is left untouched, so switching back loses nothing.

From the CodeCanyon "WooCommerce Shipping Tracking" plugin

Carrier, tracking number and dispatch date are converted the first time each order is loaded. Custom carriers, extra shipments and notes come across too. So do your settings: messages in every language, the order statuses, your enabled carriers, the default carrier, and the dispatch date option. The placeholders are the same in both plugins.

Translations. This plugin has a new text domain, vanquish-shipping-tracking-for-woocommerce. Since version 1.5.4, a translation you had made for the old plugin, for example with Loco Translate, is still used for the phrases that did not change, about 25, among them "Shipping tracking", "Tracking number", "Dispatch date", "Tracking link" and "Track". The old files are only read, and a translation of this plugin always wins. The other phrases are new: translate them once, on translate.wordpress.org or with Loco Translate.

Take a backup first. The migration clears the old plugin's data as it converts it. Nothing is lost, but going back to the old plugin is not clean.

Integration with Multiple Addresses Premium

With the Premium versions of both Shipping Tracking and Vanquish Multiple Addresses, an order that Multiple Addresses splits across destinations opens in Shipping Tracking with one shipment per destination. The products are already assigned to each shipment, so you only type the tracking numbers.

  • Nothing reaches the customer until you fill a shipment in.
  • An order that already has tracking is left alone.

Both plugins must be Premium. The integration needs Multiple Addresses 1.1.0 or later and Shipping Tracking Premium 1.2.1 or later.

Troubleshooting

The carrier link opens a generic page, not the parcel

Check, in this order:

  1. Under Shipping Tracking → Shipping companies, does the carrier have the Direct link mark? Without it, the carrier only has a generic tracking page.
  2. Under Shipping Tracking → Settings → Tracking link, choose a universal tracking page for these carriers. The table on that screen shows where each link goes.
  3. For a custom carrier, check that its Tracking URL contains %s. Custom carriers always keep the link you wrote.

Most common cause. Most carriers in the list only have a generic tracking page. The universal tracking page option is off until you choose it.

The customer does not see the tracking

  1. Check Show tracking on statuses under Shipping Tracking → Settings. The order must have one of the ticked statuses.
  2. For emails, check that Add the tracking info to WooCommerce order emails is on.
  3. Make sure you pressed Update. The tracking is saved with the order.

A second tracking from a shipping service does not show

The free version shows one tracking per order. The others are kept on the order and appear by themselves when you switch to Premium.

A service cannot send tracking

If WooCommerce Shipment Tracking or Advanced Shipment Tracking is active, the API is left to them. Deactivate them.

The Track shipment button is missing

The carrier has no tracking link. For a custom carrier, add a Tracking URL.

For developers

Attach tracking from your own code with vanstr_set_tracking():

if ( function_exists( 'vanstr_set_tracking' ) ) {
	vanstr_set_tracking( $order_id, '1Z999AA10123456784', 'ups', '2026-09-09' );
}
  • The arguments are the order (an id or a WC_Order), the tracking number, the carrier and an optional dispatch date as Y-m-d.
  • For the carrier, use the slug shown in brackets under Shipping Tracking → Shipping companies, or the id of one of your custom companies.
  • A date in another format is refused. Leaving it out keeps the date the order already has.
  • Call it any time after plugins_loaded. It returns true when the tracking was written, false when WooCommerce is unavailable or the order does not exist.
  • Each call adds an order note.

The customer lookup form is the [vanstr_tracking_form] shortcode, with an optional title attribute.

The plugin ships a POT file for translations. With WPML or Polylang active, the settings pages show one input per language for the customer-facing text.

Multiple shipments and PayPal Premium

An order can have several shipments, each with its own carrier, tracking number, dispatch date, note and products. Click + Add shipment in the Shipping tracking box. Each further parcel folds into a row you open with a click. The box tells you when a product is in no parcel.

  • Every further tracking sent by ShipStation or a shipping service becomes a shipment.
  • Under Shipping Tracking → Settings → Per-product tracking, the tracking link can show next to each product in the order details and emails.
  • Tick Email the customer about this parcel to send the Order shipped email. Edit it under WooCommerce → Settings → Emails.

PayPal tracking

With WooCommerce PayPal Payments 3.1.0 or later, the tracking of each order paid through it is added to the PayPal transaction, whether you type it in, import it or a service sends it. A note on the order says so.

Payment not captured yet? If PayPal cannot take the tracking yet, the order note says why. It is sent again the next time the tracking of the order changes.

Shipment status, monitoring and emails Premium

Timeline on the order page

Under Shipping Tracking → Settings → Shipping timeline, choose Where the status comes from:

  • AfterShip, TrackingMore or track123, with your own API key. Use Test connection to check it. The status is shown as a timeline drawn by your store.
  • 17TRACK widget: no account and no API key. It is 17TRACK's own widget, with its logo and an advertising banner.

Then switch on Show the shipment status to your customers.

Shipment monitoring

In the Shipment monitoring section of the same page, tick Check tracked shipments automatically and set How often. Then choose:

  • Tell the customer when: out for delivery, available for pickup, delivered.
  • Tell me when: a shipment reports a problem, or has not moved for a number of days.
  • Stop watching after: orders older than this are left alone.

Use Save and check now to run one pass at once. Each event is announced once per shipment. What the carrier reports also shows in the Tracking column of the orders list.

Monitoring needs an API key. With the 17TRACK widget the status never reaches your site, so it cannot feed the emails, the alerts or the orders list.

The emails

Edit Order shipped, Shipment status update and Shipment needs attention (admin) under WooCommerce → Settings → Emails. Their Subject, Email heading and Additional content accept {order_number}, {tracking_number}, {carrier} and {associated_products}, plus {status} on the status update and {issue} on the admin alert.

Your {carrier} parcel: {status}

Estimates and delivery dates Premium

Go to Shipping Tracking → Delivery dates. It has three tabs:

  • Products: an estimated shipping date on the product page, cart, checkout, order and emails. Set rules per product, category or tag: shipping days, cut-off hour, processing days, holidays and an optional date range. You can set the text shown for out-of-stock products.
  • Shipping methods: a "3–5 days" style estimate for each shipping method of each shipping zone, shown with the method in the cart and at checkout.
  • Customer's choice: let customers pick a preferred delivery date, and an optional time slot, at checkout. You set the lead time, the latest date and the excluded weekdays and dates. You can change the date from the order screen.

All three work in both the block checkout and the classic checkout.

CSV import and Quick assign Premium

Go to Shipping Tracking → Bulk tracking. It has three tabs: Quick assign, CSV import and Scheduled import.

CSV import

Drag and drop a CSV with one row per shipment. Comma, semicolon or tab separators are detected on their own. Use Download a sample CSV to start.

order_id,carrier,tracking_number,dispatch_date,note,order_status,notify

Only order_id is required. Under How are dates written in your file? choose DD/MM/YYYY, MM/DD/YYYY or YYYY-MM-DD. An order whose date cannot be read is reported and left untouched.

Scheduled import. The Scheduled import tab fetches a CSV from a URL you set, for example a feed from your warehouse. Nothing is sent to that URL.

Quick assign

  1. Set the carrier, the dispatch date and the customer email once for the whole batch.
  2. Scan or type each tracking number and press Enter for the next row.
  3. Check the status of each row: Ready, Incomplete or Not changed. Incomplete rows are not saved.
  4. Save. You can filter the list, for example with Only orders without tracking, and change the order status after saving.

Still stuck?

Tell me the carrier, where the tracking should appear and what you see instead.

Get support