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 would I use them?
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 access Manage→Meta Keys to create and adjust them.
This is what Admins see 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"). True / False values accept 1 and 0, respectively. For best results, combine the Meta Fields with another search filter like Status.
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 like "vendor_sku" or "color_code". In this way, Meta Keys are a tool for receiving teams to identify items.
Check out our documentation here.
Adding Meta Values via CSV Upload
Meta Values can be added via CSV Order upload or the API.
CSV header format:
Attached below 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 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.