Overview
Plan scope for the examples below: Seed includes the standalone tracking page and its status timeline, with up to 500 tracked shipments per month. Admin delivery-date editing requires Growth or Pro. The order-tab AJAX timeline, email timeline images, custom carriers and advanced delivered-by-date tools require Pro.
TrackEasy gives customers a branded shipment tracking page with a status timeline. It can refresh carrier events from configured APIs; Pro adds timeline images for customer emails and advanced Delivered By Date (DBD) controls in the admin orders grid.

This module helps you:
- Show customers a live delivery timeline without them contacting support
- Pull real tracking events straight from FedEx, UPS, USPS, DHL, Australia Post, StarTrack and Team Global Express (formerly Toll), with 17TRACK as a paid fallback for any other carrier
- Email and text customers when the carrier reports pickup, out for delivery or delivery (SMS is Pro), and email them about a missed delivery, a parcel ready to collect or a delivery problem
- Add a tracking link, QR code, and timeline image to any transactional email template
- Display and inline-edit the Delivered By Date directly in the admin orders grid
- Surface product recommendations on the tracking page to drive repeat purchases
When to use this
Use TrackEasy when you want to:
- Reduce "where is my order?" support tickets by giving customers a self-service tracking page
- Automatically update the estimated delivery date from carrier scan events rather than setting it manually
- Add a timeline image and tracking link to your shipment confirmation emails
- Show cross-sell recommendations on the post-purchase tracking page
- Inline-edit delivery dates for individual orders without opening each order record
Key capabilities
- Standalone tracking page - a public, token-authenticated URL customers can open without logging in
- Carrier API polling - background jobs refresh tracking events from FedEx, UPS, USPS, DHL (including eCommerce GM numbers), Australia Post, StarTrack and Team Global Express (formerly Toll). Each undelivered parcel is checked about every 15 minutes, and the tracking page also refreshes when a customer opens it. See How often tracking refreshes
- 17TRACK fallback - a paid 17TRACK account adds tracking for any other carrier
- Custom carrier matching - recognises the right carrier from the shipment title, the tracking number or your own rules
- Delivery timeline - five steps (Ordered, Packed, Shipped, Out for delivery, Delivered) that follow the carrier's scans
- Delivery timeline image (Pro) - generates an SVG/PNG milestone graphic of those steps that embeds in emails
- DBD management (Pro for carrier updates; Growth or Pro for manual editing) - calculates and updates the Delivered By Date from carrier responses; supports manual override in the orders grid
- Email previews - preview the standard delivery-update email; designed layouts come from Great Magento Emails
- Shipment notification rules (Pro) - choose email, SMS or both for carrier events (shipment created, picked up, in transit, out for delivery, delivered) or timeline steps, each sent once per shipment. See Which events send emails and texts
- Missed delivery, ready to collect and delivery problem emails (Pro) - starter rules and templates, with Great Magento Emails designs. See Email customers when a delivery is missed, ready to collect or has a problem
- HTML shipment timeline (Pro) - show evidence-based stages inside Magento shipment emails
- Email template variables - inject tracking data, timeline image, standalone page URL, and QR code into any Magento transactional email
- Delivery update notifications - sends customers an automatic email when their DBD changes
- Post-purchase upsell block - shows cross-sell or CMS block recommendations below the timeline on the tracking page
- Google Analytics UTM tagging - upsell product links and the tracking links TrackEasy generates for the storefront and for emails carry configurable UTM parameters for ROI attribution
- ShipperHQ bridge - automatically populates DBD from the ShipperHQ-selected delivery date at order placement (Pro plan)
- ShipStation bridge - calls the ShipStation v2 Rate API at order placement to set an initial DBD estimate (Pro plan)
In this guide
This guide is split across several pages so each one stays quick to read and easy to search. This page covers what TrackEasy does, how to install it and the frequently asked questions. The detailed instructions are on these pages:
- TrackEasy: Delivery Emails, SMS and Timeline Setup: Set up delivery-stage emails, consented SMS, the HTML shipment timeline, and the events that trigger notifications. Covers Preview the delivery-update email, Send pickup and delivery-stage emails (Pro), Add consented shipment SMS to a rule (Pro), Add an HTML shipment timeline (Pro), Which events send emails and texts, Set up the delivery timeline in emails (Pro), Confirm your SMS setup before your first shipment.
- TrackEasy: Carriers, Delivery Dates and Tracking Page: Connect carrier APIs, match custom carriers, understand tracking refreshes, calculate delivery dates, and set up the tracking page. Covers Add a carrier and connect its API credentials, Test Team Global Express with a recent consignment, Match custom carriers and tracking numbers, How often tracking refreshes, What the timeline shows, Configure delivery date (DBD) calculation, Set up the standalone tracking page.
- TrackEasy: Reference, Tips and Troubleshooting: Feature reference, advanced configuration, best practices, and answers to common tracking problems. Covers Features reference, Advanced configuration, Tips & best practices, Troubleshooting.
Installation
Bought on Adobe Commerce Marketplace? Your purchase comes with a Moogento account: set your password from the activation email, then follow the steps below with the Composer keys and licence key in My Plugins. If the email has not arrived, contact Moogento support.
TrackEasy installs via Composer, then activates with a license key from your Moogento.com account. The whole flow takes about 5 minutes.
Prefer a hands-off setup? Our team can install and configure the extension for you - see the paid install service.
Step 1: Get your Composer keys from Moogento.com
- Sign in at https://www.moogento.com and open My Plugins in your account menu.
- Find TrackEasy in the list of plugins you own.
- Generate (or reveal) the Composer access keys for that plugin - a public key and a private key.
- Add your install domain to the key. Each Composer key is tied to a specific domain - if you're installing on
yourstore.com, addyourstore.comto the key's allowed domains. The Composer download will be rejected on any other domain.
If you run staging and production on different domains, add both - separate keys per environment are fine too.
Step 2: Install the module with Composer
From your Magento 2 root directory:
composer require moogento/m2-trackeasy
When Composer asks for credentials, paste the public key as the username and the private key as the password. They'll be cached in ~/.composer/auth.json for future runs.
Step 3: Enable the module in Magento
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
Run php bin/magento module:status Moogento_Trackeasy - you should see it listed as enabled.
Step 4: Add your license key in the Moogento admin
- For a direct purchase, copy the TrackEasy license key from My Plugins at moogento.com. For a Marketplace purchase, check your Moogento account for an issued key and contact Moogento support if it is missing.
- Open Stores > Configuration > Moogento > License in Magento Admin. Add the Installation Domain shown on this page to the key in your Moogento account.
- Paste the key into the key field and click Add key.
- Under Registered Keys for this Installation, confirm that TrackEasy appears with the correct plan.
The license validates within a few seconds. You should see the module's status flip to active. If it stays inactive, double-check the domain on the license matches where you've installed - domain mismatch is the most common cause.
Extra steps for TrackEasy
TrackEasy runs its background jobs automatically in the default cron group:
- Notifications run every minute; they send the customer emails and texts you have switched on.
- Token refresh runs every 5 minutes; it ensures each order has a secure tracking token.
- Carrier polling runs every 10 minutes; it queues carrier API requests for active shipments. Each parcel is checked about every 15 minutes while it moves, then about hourly once it is over 3 days old or the carrier has given a delivery date. Polling stops at delivery, or 30 days after the tracking number was added.
- Timeline cleanup runs daily at 3:30 AM; it removes old timeline image files after delivery.
Confirm that Magento cron is running on your server. If cron is not active, carrier updates and DBD recalculation will not occur.
Setup overview
Most setup happens in:
Stores > Configuration > Moogento > TrackEasy
You'll mainly work with:
- General - enable the module and toggle verbose logging
- Design: Orders Page - calendar-style DBD display in the admin orders grid
- Design: Timeline steps - configure the Packed and middle steps, step labels, the emails sent at each step, and DBD/SBD calculation rules
- Design: Tracking Pages - standalone page layout, contact info block, QR code, and post-purchase upsell block
- Setup: Emails - email template variables and timeline image settings
- Setup: Carrier Tracking APIs - add and manage carrier API credentials
- Setup: Google Analytics - UTM parameter configuration for tracking links and upsell links
- Integration: ShipEasy - allow ShipEasy CSV imports to update DBD
- Integration: ShipperHQ Delivery Date - pull the ShipperHQ-selected delivery date into DBD at order placement (Pro)
- Integration: ShipStation Delivery Date - pull a ShipStation rate estimate into DBD at order placement (Pro)
Common setups
- Preview the delivery-update email
- Send pickup and delivery-stage emails (Pro)
- Add consented shipment SMS to a rule (Pro)
- Add an HTML shipment timeline (Pro)
- Add a carrier and connect its API credentials
- Test Team Global Express with a recent consignment
- Match custom carriers and tracking numbers
- How often tracking refreshes
- What the timeline shows
- Which events send emails and texts
- Set up the delivery timeline in emails (Pro)
- Configure delivery date (DBD) calculation
- Set up the standalone tracking page
- Confirm your SMS setup before your first shipment
FAQs
How do I add a tracking link to my shipment confirmation email?
Add {{var trackeasy_standalone_page_url}} to your shipment email template - the compact plain-text link is the default and stays readable even in email apps that strip HTML. For example: <a href="{{var trackeasy_standalone_page_url}}">{{var trackeasy_standalone_page_url}}</a>. Prefer a styled button? Use {{var trackeasy_standalone_page_link|raw}} for a ready-made one. See Set up the delivery timeline in emails for the full list of available variables including the timeline image and QR code.
How do I set up Magento 2 shipment tracking with FedEx?
Go to Stores > Configuration > Moogento > TrackEasy > Setup: Carrier Tracking APIs, add a new carrier row, select FedEx, and enter your OAuth 2.0 Client ID and Client Secret from the FedEx Developer Portal. Start with sandbox credentials and use the built-in Test button to confirm they work before switching to production. See Add a carrier and connect its API credentials for credentials for all supported carriers.
What is the difference between sandbox and production mode for carrier APIs?
Sandbox mode sends API calls to the carrier's testing environment using test tracking numbers; no real shipment data is returned. Switch to production once your credentials are confirmed working so that real customer tracking numbers return live events. FedEx sandbox uses apis-sandbox.fedex.com; UPS sandbox uses wwwcie.ups.com. Toggle the UPS environment at Stores > Configuration > Moogento > TrackEasy > UPS: Live Calls > UPS API Environment.
Can I add a new carrier that is not in the list?
TrackEasy ships with direct API polling for FedEx, UPS, USPS, DHL (including eCommerce GM numbers), Australia Post, StarTrack and Team Global Express (formerly Toll). Royal Mail and Evri are link-only (the tracking number and a public carrier URL are shown; no event polling). For any other carrier, add 17TRACK as a paid fallback: it covers 2,100+ carriers and finds the carrier from the tracking number. If a shipment uses Magento's Custom Value carrier, see Match custom carriers and tracking numbers.
Why is the Delivered By Date not updating from the carrier?
The most common reason is that Update: DBD based on shipper API response? is set to No. Set that option to Yes at Stores > Configuration > Moogento > TrackEasy > Design: Timeline steps > DBD: Delivered By Date. Also note that Royal Mail and Evri are link-only and do not return structured ETA data, so DBD is not updated from their responses automatically. Carrier updates rely on both Magento cron and a running message queue consumer - cron only queues tracking numbers, the consumer is what actually calls the carrier API - see DBD is not updating from carrier data for the full checklist.
How do I set up Team Global Express (Toll) tracking?
Ask Team Global Express to add the MOOGENTO profile to your MyTeamGE account, then enter the Client ID and Client Secret under Setup: Carrier Tracking APIs and allow outgoing port 6930 on your server. Test it with a consignment from the last few days. See Test Team Global Express with a recent consignment.
How often does TrackEasy check the carrier?
About every 15 minutes for each undelivered parcel, then about hourly once it is over 3 days old or the carrier has given a delivery date. It stops at delivery or after 30 days, and refreshes again whenever the tracking page is opened. See How often tracking refreshes.
When does TrackEasy mark an order as Delivered?
When a carrier is tracking the parcel, only when the carrier confirms delivery. The delivered-the-day-after-the-delivery-date behaviour applies only to parcels without live tracking. See When an order is marked Delivered.
Does TrackEasy send automatic emails when the delivery date changes?
Yes. Set Stores > Configuration > Moogento > TrackEasy > Design: Timeline steps > Emails at each step > Email when the delivery date changes to Yes, and choose a delivery date email template. A customer email is sent each time the Delivered By Date changes - whether from a carrier API update or a manual edit in the admin.
Does TrackEasy work with Hyvä, Luma, and Porto themes?
Yes. The standalone tracking page and all frontend blocks are compatible with Luma, Porto, and Hyvä themes. Use the Custom CSS field at Stores > Configuration > Moogento > TrackEasy > Design: Tracking Pages > Standalone tracking page: Custom CSS to match the tracking page to your theme's typography and colors.
How do I show product recommendations on the tracking page?
Product recommendations are enabled by default. Go to Stores > Configuration > Moogento > TrackEasy > Design: Tracking Pages > Add: Upsell/Custom Block and confirm Enable = Yes. The block shows cross-sell products configured on the ordered items; if none are configured, it falls back to in-stock products from the same category. You can restrict recommendations by category, minimum price, or a specific product attribute value, or replace the block with a CMS block or custom HTML. See Set up the standalone tracking page for how the attribute filter's Value field adapts to each attribute's type.
What happens if I disable TrackEasy?
Disabling TrackEasy (moogento_trackeasy/moo/enable = No) stops the standalone tracking page from rendering, removes TrackEasy variables from email templates (they output nothing), pauses carrier polling crons, and hides the DBD column widget in the orders grid. Order data - DBD, tracking tokens, timeline tokens - is not deleted. Re-enabling the module restores all functionality.
Which plan do I need for full carrier API polling and DBD management?
Carrier polling and the standalone page with its status timeline are available with supported configuration. The order-tab AJAX timeline, email timeline image, advanced DBD tools, ShipperHQ and ShipStation delivery-date bridges require Pro. Admin delivery-date editing requires Growth or Pro. The Seed plan supports up to 500 tracked shipments per month and can show DBD estimates; editing dates requires Growth or Pro. Check or upgrade your plan at https://www.moogento.com > My Plugins > TrackEasy.
Does TrackEasy integrate with ShipperHQ or ShipStation?
Yes. The ShipperHQ bridge (Pro plan) reads the delivery date selected by ShipperHQ at checkout and writes it directly into the Delivered By Date field - no manual entry needed. The ShipStation bridge (Pro plan) calls the ShipStation v2 Rate API at order placement to set an estimated delivery date. Both are configured at Stores > Configuration > Moogento > TrackEasy under the Integration sections.
Related guides
- Email design - shared styles, storefront look and previews
- ShipEasy - admin order processing, bulk shipping operations, and the orders-grid tracking column; works alongside TrackEasy (ShipEasy adds tracking numbers on the admin side; TrackEasy displays them to customers). Requires ShipEasy Growth or Pro for the CSV import DBD update integration.
- Pulse - real-time admin dashboard; includes a TrackEasy widget showing live delivery status across open orders.
- GiftEasy - gift card module; TrackEasy tracking pages are separate from gift card delivery flows.
Need help?
- moo@moogento.com
- Include:
- Magento version
- Module name
- What you're trying to do
