When you add a shipment to TrackMage via a CSV file or import the shipment from your e-commerce store, tracking information about the order is loaded into the system. The default data fields (columns) include the tracking number, origin carrier, and status.

You can also add custom data fields to meet your business needs. For example, you can add a Stock Keeping Unit (SKU) data field using custom fields in TrackMage.

Data Types

For validation purposes, you can create fields with specified data types. There are various types available in TrackMage:

• Text (String): accepts text, numbers, or a combination of text and numbers as input. For example, the text data field accepts input like 110, ORD, or 987NNt.

• Number (Integer): accepts numeric values only. For instance, you will have to set the data field type to Number to add an SKU custom field.

• Date (DateTime): accepts dates from the date-picker as input.

• Phone: accepts phone numbers with the correct dialing codes as input.

• Email: accepts valid email addresses as input.

• Link: accepts valid URLs as input.

Manage Fields

You can create, edit, delete, sort, and search custom fields with the Manage Fields option. 

1. Log in to your TrackMage account.

2. From your dashboard, navigate to E-commerce > Shipments.

3. Click Settings at the top-right corner of the page and select Manage Fields from the dropdown.

How to add a custom field

1. On the Manage Fields dialog box, click Add New.

   
   

   
   

   
   

2. Enter the values for the custom data field: 

title—the name of the custom field.

code—the unique identifier for the custom field. This will be populated by default.

Field Type: the data type for the field.

3. When you are done, click Submit. You will get a notification when the custom field has been added.

How to edit a custom field

1. On the Manage Fields dialog box, navigate to the desired custom field using the slider and click the edit icon next to it. 

You can only edit a custom field’s name. 

2. On the Edit Field popup box, enter a new name and click Save. You will get a notification that the field was updated successfully.

How to delete a custom field

1. On the Manage Fields dialog box, navigate to the desired custom field using the slider and click the delete icon next to it. 

2. Confirm that you want to delete the custom field and click the Yes, Delete button. You will get a notification that the field was deleted successfully.

How to sort custom fields

1. On the Manage Fields popup box, navigate to the desired custom field using the slider.

2. Click the custom field and drag it up or down as desired. 

How to search for a custom field

1. On the Manage Fields popup box, you will see a search bar at the top of the box.

2. In the search bar, type in the custom field you want to find and the search results will be shown immediately.

Grid navigation

You can customize the shipment grid to display selected fields. 

1. From the Shipments page, select Settings at the top right corner of the page.

2. On the popup box, check the box next to a field to display on the grid and vice versa. The changes take effect immediately.

Access Fields in the Interface

To access the custom fields in the interface, click the three-bar icon on the desired shipment(row) and select the Custom Fields tab. You will see a list of custom fields.

Create Fields in the Interface

To create custom fields in the interface, select the Custom Fields tab and click on the Create a New Field button.

In the Add a New Field popup box, enter values for the custom field:

title—the name of the custom field.

code—the unique identifier for the custom field. This will be populated by default.

Field Type: the data type for the field.

When you are done, click Submit. You will get a notification when the custom field has been created.