Blueprint SyndicateWooCommerce plugins · AI agents
Blueprint Syndicate

Metro Driver Docs

Last updated November 12, 2026

Metro Driver docs

How to set up Metro Driver on a WooCommerce store, from install to the first cash count. Sections marked Pro need Metro Driver Pro.

Where things are: after you activate the plugin, WordPress admin has a Delivery Drivers menu with Live map and Metro Driver settings. The settings screen has these tabs: Drivers list, General, Drivers, Modules, Routing, Google API keys, Customer tracking, Texts, App, Metro Driver Pro, Licence, Cash and Migration. Pro adds Orders out and Cash count under Delivery Drivers, and a Scheduling menu for staff.

1. Install

You need WordPress 6.2 or later, WooCommerce and PHP 7.4 or later.

  1. Install and activate WooCommerce if it is not already running.
  2. In WordPress go to Plugins > Add New > Upload Plugin, choose the Metro Driver zip and install it.
  3. Activate Metro Driver. It creates a Driver portal page and an Order tracking page.
  4. Create each driver under Users.
  5. Add them on Metro Driver settings > Drivers list: enter the email or username and press Add driver. There is no limit on drivers.

Adding Pro: keep the free Metro Driver plugin active, then upload and activate the Metro Driver Pro add-on zip from your account downloads. Pro needs the free plugin. Your data stays.

2. Enter your licence key (Pro)

  1. After purchase your licence key arrives by email. It looks like MDRV-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX.
  2. In WordPress go to Delivery Drivers > Metro Driver settings and open the Licence tab. Paste the key and press Save. Saving the key activates this site.
  3. The Licence status table should read “Licence active” and show your plan and expiry date.

One licence covers one site. To move it to another site, press Deactivate this site on the Licence tab, then save the key on the new site. Check now re-checks the licence on demand.

The plugin checks the licence once a day. If it cannot reach the licence server, it keeps working on the last confirmed status for 14 days. Your host needs the PHP sodium extension, which the plugin uses to verify the answer.

When your licence expires or is cancelled, the Pro add-on turns itself off on that date and the free plugin keeps running. Nothing is deleted. Entering a valid key turns Pro back on. If your site cannot reach our licence server, Pro keeps working on the last confirmed status for 14 days.

The $29 monthly plan renews automatically each month until you cancel it from My Account. If you cancel partway through a month, Pro stays on until that paid month ends. The 1-year and 3-year plans do not renew automatically: we email you 14 days and 3 days before the licence ends, and you buy again to continue. A lifetime licence never expires.

3. Connect drivers with the store code (Pro)

  1. Each driver installs the free Metro Driver app from the App Store or Google Play.
  2. In WordPress open Scheduling > People and find the panel “Connect the app to this store”. It shows a QR code, your 6-digit store code and a connect link.
  3. The driver scans the QR code with the phone camera, or types the store code in the app. The store code needs your store at the root of a domain on https. If your site runs on a port or in a sub-folder, use the QR code or the connect link.
  4. The driver confirms the store name and signs in with their own account, the same user you created in step 1.

The store code only finds your store. Nobody gets in without an account you created. Metro Driver settings > App lists the signed-in app devices, and Revoke all removes a person’s app sign-ins.

4. First delivery, end to end

  1. An order comes in as usual.
  2. Dispatch opens the order and assigns a driver. In Pro the driver’s phone gets a push notification with the order number.
  3. The driver opens the order: in the driver web page in a phone browser (free), or in the app (Pro).
  4. The driver marks it Out for delivery. The customer gets an email and can follow the order on the tracking page, which shows an approximate driver pin.
  5. At the door the driver marks it Delivered, or Not delivered with a reason. Each step is written to the order notes.

In Pro, dispatch can watch drivers on Delivery Drivers > Live map, and the routing settings plan the stop order and delivery time estimates once your Google key is in.

Driver app notifications go through a relay run by WFV LLC. The relay checks your licence and passes the message on to the push service. It does not store messages. Notification text can include whatever your store puts in it, so keep customer details out of it where you can.

Route order and delivery times need your own Google key with the Geocoding API switched on, because orders must have a map position first. Without a key there is no route order and no delivery time. They are worked out on our server from travel times between stops. No addresses or customer details are sent. If the server cannot be reached, deliveries continue in the order they were assigned and show no delivery time until it is back.

5. Cash count (Pro)

  1. Open Delivery Drivers > Orders out. It shows what each driver is holding.
  2. When a driver hands cash over, pick the orders and press “Cash turned in for the picked orders”. Part payments, amounts a driver still owes and items that came back or were lost are recorded here too. An order can be re-sent with another driver.
  3. At the end of the day open Delivery Drivers > Cash count, count the safe, enter the amount and press Save the count.
  4. The screen shows expected against counted. If they differ, read “Why the safe might not match” for the reasons.

Entries can be undone, notes can be added, and the day’s entries can be downloaded as a CSV.

6. Customer texts (Pro)

Emails work out of the box. Texts send through your own account with Twilio, Vonage or Telnyx.

  1. Go to Metro Driver settings > Texts.
  2. Choose your SMS provider and enter that account’s details (for Twilio: account SID, auth token and from number).
  3. List the texts you want on, one per line: out (out for delivery), final (driver close by), outside (driver outside), next (next stop), delivered, failed (not delivered). The default is final and outside.
  4. Edit the wording of each text. The placeholders are listed under each box.
  5. Save, then use Send test text with your own number. The test uses the saved settings.
  6. Set Customer texts to Send. It starts on Log only, which writes each text into the order notes instead of sending it.

Each text goes at most once per order. A number without a country code is treated as a number in your WooCommerce store country.

If iMessage Order Texts for WooCommerce is installed, Metro Driver sends through it first and uses your SMS provider when it cannot.

7. Google Maps key

Maps, route planning and ETAs use your own Google key, so Google bills you directly. Paste a browser key and a server key on Metro Driver settings > Google API keys, test them, and set the daily caps. The full walkthrough is here: How to get a Google Maps API key for Metro Driver.

8. Moving from Local Delivery Drivers for WooCommerce

  1. Install Metro Driver while Local Delivery Drivers is still active. The two can run side by side.
  2. Open Metro Driver settings > Migration. Under Sources found, Metro Driver lists what it detected and prepares a dry-run report. Press Open report to see what would be copied. Nothing changes at this point.
  3. Run the migration. It copies your drivers and settings across.
  4. Run a few deliveries on Metro Driver while the old plugin is still there.
  5. When you are ready, deactivate Local Delivery Drivers. The Migration tab then offers “Take over the portal URL”, so drivers keep the address they already know. It has an Undo.

Stuck on a step? Send the dry-run report to [email protected].

9. Updating Pro

While your licence is active, a new version of the Pro add-on appears on the Plugins screen and under Dashboard > Updates. Press Update now, as for any other plugin.

If you would rather update by hand:

  1. Sign in to your account on blueprintsyndicate.com and download the new Metro Driver Pro zip.
  2. In WordPress go to Plugins > Add New > Upload Plugin, choose the zip and confirm that it replaces the current version.

Your settings, drivers, orders and licence key stay in place.

10. Removing the plugin

Deleting Metro Driver keeps your payroll and delivery records by default. To wipe everything, switch on “Delete ALL Metro Driver data when the plugin is deleted” in the settings first.

11. Getting help

Email [email protected]. Tell us your site address, your plugin version and what you were doing when it went wrong. For licence problems, include the “Last problem” line from the Licence tab. Never send your full licence key, Google keys or texting account secrets by email.

Metro Driver is sold and supported by WFV LLC.