A Meta Field consists of a Meta Key, which defines the property you are defining, and a Meta Value, which is the value of the property.
For example, the Meta Key "gs1_template" may have a Meta Value of "Default".
Why We Use Meta Values
You could use Meta Values to store arbitrary data Whiplash doesn't need to ship Orders, but you need on the Packing Slip or some other resource. They can also be used in Search Filters, which can be applied to Rules, Bulk Actions, or Reporting.
We don't accept arbitrary Meta Keys. They must first be validated and created by an Admin. Right now, Admins can navigate to "Manage" and select "Meta Keys" to create and adjust them.
This is the Admin's view when they edit Meta Keys:
Using Meta Values
Search Filters are powerful. You can find orders containing Meta Fields (i.e. "Batch all the order-type: VIP orders") or use them for Rules (i.e. "if packaging-type: eco, use paper mailers").
When using a boolean (True/False) in meta field search filters, use the value 1 for true and 0 for false. For best results, combine the Meta Fields with another search filter. An example would be to include a filter like Status or a date range.
The following equates to "is_gift: true":
Shipnotice.item and Shipnotice Meta Fields are searchable on the Ship Notice Details page. These are most frequently used when locating an inbound item by a Meta Key, such as "vendor_sku" or "color_code". In this way, Meta Keys are a tool for Receiving Teams to identify items.
Check out our documentation regarding templates here.
Adding Meta Values via CSV Upload
Meta Values can be added via CSV Order upload or the API.
CSV header format:
Note: Attached to this article is an example of the standard Ship Notice import format being used to include Meta Keys.
They're surfaced in the UI, right?
No! But this is intentional. Mistakes happen when we’re relying on humans making right decision based on written instruction for thousands of packages a day. We’re all about automation.
For example, we might use the filter Meta Field packaging_type: eco-friendly to apply a Rule.
Or, we might use user_status: VIP to create Batches.
This means that warehouse staff are getting instructions in the way they’re used to—contextually, via the packing and batching workflows—and don’t need to change their process at all to ship orders in the way you intend.
One exception: Item level Meta Fields are visible on the Item Details page, under the "More" menu. This is to give receiving teams as much information as possible about the items and give them the best possible chance of identifying the right thing during receiving.
What are Meta Fields?
What do Meta Fields consist of?
How are Meta Fields used in searches, receiving, and templates?
How do I add Meta Fields via CSV upload?
- ship notice meta key example.csv191 Bytes