Customer tracking guide

Share and embed the tracking page

Give a customer a branded, live view of one job without requiring them to create an account or sign in.

Updated September 3, 2026
Treat every tracking link as customer data. The link is private, and anyone who has it can view that job. Use the complete link created for the job. Do not replace part of it with a job ID or publish one link as a permanent site-wide tracker.

How the tracking page works

Every job has its own public tracking URL. A customer who opens it can see the current workflow status, route progress, pickup and destination, driver and vehicle information, and the latest available location and ETA. The page updates as RouteIQ receives changes.

ExperienceAccount required?Best use
Tracking pageNoA direct, read-only view of one job
Customer AppYesRequesting jobs and keeping active and past work together

1. Brand the tracker

  1. Open Settings → Branding.
  2. Set the site or brand name, tagline, logo, brand color, accent color, and theme.
  3. Use the Tracking page preview, then switch between mobile and web.
  4. Add your Customer App’s App Store and Google Play URLs if you want the tracker to show Get the App.
  5. Select Save.

The tracker chooses the matching store for iOS or Android when possible. Those links should point to the customer app, not the Driver App.

RouteIQ Branding settings showing company name, tagline, logo, colors, theme, app-store fields, and a live mobile tracking preview
Preview before customers see it. One brand configuration drives the tracker, Customer App, and invite banner.

2. Share a job’s tracking link

  1. Open Jobs and select the job the customer should follow.
  2. In the job editor header, select the link button labeled Copy tracking link.
  3. Paste the complete URL into the customer’s email, SMS, or support conversation.
  4. Open the pasted link once yourself before sending it.
One job, one link.

The copied URL includes both the job’s share token and your site identity so the shared tracker can load the right job and the right brand.

3. Embed the tracker

Use an embed when your website or customer portal should contain the live tracker instead of sending visitors to a separate page.

Generate an embed for a real job

  1. Open the job and select Embed tracker beside the tracking-link button.
  2. Copy the generated iframe and place it in the page that customer will open.
  3. Keep the iframe’s geolocation permission and responsive width unless your site requires a different layout.

Prepare a reusable template

  1. Open Settings → Tracking Page.
  2. Choose the iframe width and height.
  3. Copy the snippet and replace SHARE_TOKEN on your server for each job.

Never place one customer’s live token in a reusable page template or client-side source intended for other customers.

RouteIQ Tracking Page settings showing iframe width, height, and a copyable snippet with a per-job share token placeholder
The settings page creates the template. Your server supplies a different secure share token for each job.

4. Keep tracking live

The page can only display information RouteIQ currently has. For the best experience:

  • Dispatch the job or its route to the correct driver.
  • Ask the driver to use the RouteIQ Driver App and go On Duty.
  • Allow precise and background location on the driver’s phone.
  • Keep stops, addresses, time windows, and workflow states current.
  • Use a configured mapping provider for route and ETA calculations.

Location collection stops when the driver goes Off Duty. A tracker can still show job details and status, but its live position and ETA may no longer advance.

5. Verify the customer experience

  1. Create a non-production job with valid stops and dispatch it to a test driver.
  2. Copy its tracking link and open it in a private browser window.
  3. Confirm the brand, job status, stops, driver, and vehicle are correct.
  4. Move the test job through its workflow and confirm the page updates.
  5. If using live location, move the test device and check that the map and ETA refresh.
  6. If embedding, test the iframe at desktop and mobile widths.

Troubleshooting

The page cannot find the job

Copy a fresh link from the job and use it unchanged. Do not use the internal job ID in place of the public share token.

The map is static or the driver is missing

Confirm the job is dispatched, the correct driver is On Duty, and precise background location is enabled in the Driver App.

The ETA is missing

Check that the remaining stops have valid coordinates and that an active mapping provider is assigned to the required route or matrix operation.

The iframe does not load

Confirm the token was substituted server-side, the full tracker URL uses HTTPS in production, and your site’s content-security policy permits the RouteIQ tracker host.