Meta Data

Creating Custom Attributes/Meta Data for an Order

In Commerce7, setting up meta data is a way to collect data that is relevant to your business. After creating order meta data they will appear on orders and will be included in the order export.

Note that Order Meta Data is available to add to Orders via the Admin Panel and POS. Your Customers will not see Meta Data choices for Web Orders.

  1. To create an attribute for a product, navigate to DeveloperMeta Data
  2. Click the Order tab from the options at the top of the screen and then click Add Order Meta Data
    Screen Shot 2023-01-30 at 3.44.02 PM-1
  3. Select a Title for your attribute.
    For an example, you could create an attribute for logging order referral type on Orders: "How'd you hear about us". 
  4. Code is just a reference point for doing API calls. You do not need to change this, but you can if you'd like. 
  5. Next select your Data Type. There are 11 different data types available.
  6. Decide whether or not you want your attribute to be a Required field. Learn about how this field works here.
  7. Finally you can set the Sort Order. The sort order determines the display order your Order attributes will appear in.
  8. Click Add Order Meta Data when you're finished building your attribute.
    Screen Shot 2023-02-15 at 3.46.13 PM


 

How does the Required Field option work?

  • There is no way to require Meta Data for an Order to be processed. The Order will process regardless of whether you have filled out the Meta Data or not.
  • The Required Field option is only enforced when there are multiple Order Meta Data fields. For instance, let's say you have both a 'How'd you Hear about us?' (that IS required) and a 'What's your favorite varietal' (that is NOT required).
    • If you fill out the (not required) varietal question, you will be forced to answer the (required) 'How'd you hear about us' question prior to saving that screen.
    • You are allowed to not add any Meta Data at all - and your Order will still process.

 


Testing your Meta Data Field(s)

Test in Admin

Log into any Order and click on the Meta Data tab.

Choose/enter the applicable Meta Data and Save.

Screen Shot 2023-02-15 at 3.48.02 PM-1


Test in POS

To access Order Meta Data during a POS order, select Additional Order Info in the dropdown list on the right.

Screen Shot 2023-01-30 at 3.27.11 PM

Choose/enter the applicable Meta Data and Save.

Screen Shot 2023-02-15 at 3.52.33 PM

 


    Before You Save, Choose Your Option Titles Wisely!

    If you have chosen a 'text' Data Type such as 'Radio', 'Checkbox', or 'Select', make sure to carefully select your option title. Once saved, if you later edit the title, you will only be able to filter using the new title.

    Screen Shot 2024-03-27 at 3.09.41 PM

    Example:

    1. You have Order Meta Data for "Source" and your options are: Social, Friends & Family, and Google. 
    2. You select the value of "Social" on Order #1012. 
    3. You change your Order Meta Title to rename "Social" to "Social Media".
    4. Order #1012 that has "Social" selected will not have "Social Media" selected. (This is because the backend doesn't know that "Social" and "Social Media" are the same thing. Since the text doesn't match, it thinks that it's a different value).
    5. If you filter by the Order Meta Data of "Social Media", the Order with "Social" selected will not be included in the results. (Note that unfiltered Order Exports will contain both). 

     


    FAQ

    1. Oh no! I edited my Option Title after I'd already begun using the old Title. How can I report on Orders containing both the old and new option titles? Unfiltered Order Exports contain both. You can download and sort on the applicable Meta Data column.
    2. Can I re-order the Options after the fact? Yes! As long as the text matches, there are no issues with changing the display order.