Want to see custom data in the Shopify admin, separate from tags? Now you can!

The Customer Note editor in Customer Fields allows you to display custom data directly in the Shopify admin when viewing Customers and Orders.  This is done by hooking into Shopify's customer note field, which opens up a whole new way to utilize the Customer Fields app to help make your day-to-day processes even more efficient.

The 'Customer note' is visible on 3 separate pages within the Shopify admin:

  1. The Customer page (the main list/directory)
  2. The Customer details page
  3. The Order details page

How to configure Customer Notes

You can configure how the data is transposed to the customer note using a Liquid template editor in the app admin. You can find the customer note editor by going to Settings > Customer note editor from the app admin.

Before you get started with the Customer note template editor, please keep the following in mind:

  • Existing customer note data that Shopify has on file will be preserved; the data from the app is appended to the end of the note.
  • The rendered content from the template will be inserted in between six (6) dashed lines, which help to indicate the start and end of the data block.
  • Any saved changes made to the customer note template are not retroactive, which means that existing customers with notes will remain as-is (until those customer records are updated).

Auto-configure for fast setup 

To save you time, we've built an auto-configure tool which will automatically render out the labels and variables for all of your custom data columns. If you simply want to display your custom data quickly and easily, click the 'Auto-configure' magic wand (found on the top left of the page) and all your fields will be filled in the editor automatically. Preview & save the changes, and then you're done!

Liquid editor with data column variables 

Liquid code friendly

The app's template editor for the customer note is completely Liquid friendly. This means you can use any popular control flow tags, iteration tags and filters that you need to dynamically render content in your ideal format & layout. We suggest using this documentation if you need a good reference on Liquid.

Here's an example template:

Birthday: {{ birthday }}
ID Number: {{ id_number }}

And here's what the output in the customer note field would look like for this example template:

(Existing note) This is a great customer! Always ship to their front door.
------
Birthday: 1989-03-12
Id Number: 49-230-572
------

You can format the data:

Birthday: {{ birthday | date: "%B %e" }}
ID Number: {{ id_number }}

Output:

(Existing note) This is a great customer! Always ship to their front door.
------
Birthday: March 12
Id Number: 49-230-572
------

Or only display the field if it's not blank (null):

{%- if birthday != null -%}
Birthday: {{ birthday | date: "%B %e" }}
{%- endif -%}

You can also control how (and even when) custom data is output into the customer note. For example, you could add a filter to a file upload data column so that only the file's URL is output:

{{ signed_pdf_agreement.url }}

Or change which fields are output based on a customer tag:

{%- if tags contains "wholesale" -%}
Wholesale ID: {{ wholesale_id }}
{%- else -%}
Twitter handle: {{ twitter_handle }}
Instagram handle: {{ instagram_handle }}
{%- endif -%}

Pro tip: You can add dashes like {%- if ... -%} (instead of {% if ... %}) to avoid extra lines

Data column variables

All of the available data column variables are listed in a panel on the right side of the template editor. The variables are broken into sections; Custom data columns & Standard data columns. You can click the 'Copy' button when hovering over any variable to quickly copy the variable to your clipboard and paste it wherever you'd like in the template editor.

Pro tip: If you have data columns that have spaces in the key, then you will want to wrap the key in brackets and double quotes, like so: {{ ["License Number"] }}  

Preview the output

You can use the 'Preview' tab when making changes to the template to see how your changes would look when populated with data. Please note that the app automatically generates placeholder data for the data column variables - this is just for example purposes.  

Need some help with your customer note template?

Reach out to our support team and we'll help get your customer notes formatted the way you need!

Did this answer your question?