Tracking Number Uploader App

The Tracking Number Uploader app for Commerce7 is owned and developed by a 3rd-party developer (Treefrog Digital). For questions regarding custom reports, setup, or support, please contact us at hello@treefrogdigital.com.


App Technical Description


Tracking Number Uploader integrates with Commerce7 to allow bulk importing of tracking numbers through a CSV file. Users can download a template from the app, fill in the required fields (Order Number, Tracking Number, and Carrier), and upload the file to process multiple orders at once. During the import process, the app validates the data, applies the tracking numbers to the corresponding orders, and automatically marks them as fulfilled. The system also records a log of processed orders for review and troubleshooting.

For quick access to the topic you are looking for, click the corresponding link below:

Setup Instructions


  1. Install the App on Commerce7
  • From the Commerce7 Admin Panel, go to Apps & Extensions, then select Apps. (You must have Admin Owner role to install the app)
  • Search for Tracking Number Uploader by Treefrog Digital, click on the app, and then click Install App.

2. Once installed, go to Store in Commerce7 and open the Orders page. 

3. Click the More Action menu and select Upload Tracking Number.

4. Download the CSV template provided by the app to prepare your file for upload. You can also get the template from your Admin panel by going to the Store menu, scrolling down, clicking the Tracking Number Uploader app, and then clicking Upload CSV File.

How to Upload Tracking Numbers


Step 1. Prepare the CSV file


Create a CSV file with the following columns, or download the template provided by the app. The first row of the file must contain the column headers:

  • Order Number 
  • Ship Date (optional - if not specified, the app will automatically use the upload date. Valid date formats: M/D/YYYY | MM/DD/YYYY | YYYY-MM-DD | DD MMMM YYYY | D-MMM-YY | M-D-YY | D-M-YYYY
  • Tracking Number
  • Carrier ( Available carriers: UPS | FedEx | ATS Healthcare | Australia Post | GSO | Other)
  • Inventory Location ID (optional - use only if you need to change the location; otherwise, leave blank)
  • Notify Customer (optional - enter 1, true, or yes to notify the customer, or leave blank if no notification is needed) 

Step 2 (OPTIONAL): Find the Inventory Location ID (optional — skip this step if you do not need to change the inventory location).


If you need to specify or change the inventory location:

  1. Go to Settings in Commerce7
  2. Click on Locations
  3. Select the desired location
  4. The Location ID will appear in your browser URL 

Step 3. Adding multiple tracking numbers (optional if needed)


If an order has multiple tracking numbers: 

  • Separate them with a comma in the Tracking Number field.
  • Example: 390928904680, 508020403070

Here’s a quick video demonstrating how to add multiple tracking numbers to an order VIEW VIDEO :

Step 4. Save the file


  • Save the file as a .csv (comma-separated-value)
  • The file must be smaller than 1MB.
  • The file name must not contain spaces or special characters.

Step 5. Upload the CSV file

  1. From your Admin panel, click the Store menu, scroll down, and click on the Tracking Number Uploader app. Once inside the app, click Upload CSV File.

  1. In the Title field, enter a title for your file (this title is for internal use only)
  2. In the Upload action, choose upload tracking numbers.
  3. Click the Choose File button and select your CSV file to upload.
  4. Click Save to start the import.

Step 6. Review the results


After the upload is complete, the page will refresh and return you to the main app page.


On this page, you’ll see a log of all imports done through the app. The log includes the following information:

  • TITLE: The internal title given when the file was uploaded.
  • FILENAME: The name of the actual CSV file.
  • PROGRESS: Shows Done if the import is finished or In Progress if it’s still processing.
  • STATUS: Displays Success once the file is fully processed.
  • SUCCESS: Number of orders successfully imported. Click the number to view a detailed list of uploaded orders.
  • ERROR: Number of orders that could not be imported. Click the number to see which orders failed and the error type.
  • TOTAL: Total number of orders processed, including successful and failed imports.
  • CREATED AT: Date and time the file was uploaded.

Important Steps After Import:

  1. Once your file finishes importing, the Progress column will show Done, and the Status column will show Success.
  2. Click the numbers in the SUCCESS, ERROR, or TOTAL columns to view a detailed list of orders.
  3. If the ERROR column shows any number other than 0, click it to review which orders failed and the error messages.

After the file is processed:

  • The tracking numbers will be applied to the corresponding orders.
  • Orders will be marked as fulfilled.
  • Tracking numbers can be viewed under Orders → Fulfillment in Commerce7.


How to Upload Tracking Numbers from the Order Page 


There are two ways to import your tracking information:


Option 1: Using the Tracking Number Uploader App

  • Follow the steps outlined in the How to Upload Tracking Numbers section of this documentation.

Option 2: From the Order Page

  1. In your Admin panel, go to the Store, then menu and click on Orders.
  2. On the Order page, click More Actions.
  3. Select Upload Tracking Number.

  1. You will be taken to the upload screen.

  1. From here, follow the same steps as in the Tracking Number Uploader App section to complete the import.

How to Upload Order Notes


Step 1. Download the CSV template provided by the app 


  • Go to Store in Commerce7, scroll down, and click on Tracking Number Upload 
  • Click on Upload CSV File
  • Under Upload Action, select Order notes
  • Then click on “To get started, download the order notes CSV template.”

Step 2. Prepare the CSV file


Create a CSV file with the following columns, or download the template provided by the app. 


The first row of the file must contain the column headers:

  • Order Number 
  • NoteType (Valid date formats: Note)
  • Note

Step 3. Save the file


  • Save the file as a .csv (comma-separated-value)
  • The file must be smaller than 1MB.
  • The file name must not contain spaces or special characters.

Step 4. Upload the CSV file


From your Admin panel, click the Store menu, scroll down, and click on the Tracking Number Uploader app. Once inside the app, click Upload CSV File.


  1. In the Title field, enter a title for your file (this title is for internal use only)
  2. In the Upload action, choose order notes.
  3. Click the Choose File button and select your CSV file to upload.
  4. Click Save to start the import.

Step 5. Review the results


After the upload is complete, the page will refresh and return you to the main app page.


On this page, you’ll see a log of all imports done through the app. The log includes the following information:

  • TITLE: The internal title given when the file was uploaded.
  • FILENAME: The name of the actual CSV file.
  • PROGRESS: Shows Done if the import is finished or In Progress if it’s still processing.
  • STATUS: Displays Success once the file is fully processed.
  • SUCCESS: Number of orders successfully imported. Click the number to view a detailed list of uploaded orders.
  • ERROR: Number of orders that could not be imported. Click the number to see which orders failed and the error type.
  • TOTAL: Total number of orders processed, including successful and failed imports.
  • CREATED AT: Date and time the file was uploaded.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.