Meta Fields

Michael Chen
Michael Chen
  • Updated

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 now allow arbitrary Meta Keys, eliminating the need for prior validation and creation before their usage.

Note: You must use the Line per SKU importer to upload an order.

Using Meta Values

In Searches

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":



During Receiving

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.


In Templates

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. 

Note: You must use the Line per SKU importer to upload an order.

CSV header format:




Ship Notices






Note: Attached to this article is an example of the standard Ship Notice import format being used to include meta keys.
See Create Wholesale Orders for an example of an order import format using meta fields.

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.


Related Questions:

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?