The customer directory in Customer Fields allows you to securely access all of your customer data quickly and easy. You can find the customer directory by clicking on the Customers tab from the app admin.

We've recently introduced some powerful features that allow you to apply multiple data-specific filters when searching through the list of customers. You can also create saved segments, configure how the data columns are displayed, and more! Here's a quick demo video:

The primary function of the customer directory is to view a list of customers, but there's a lot more under the surface. We've provided some details below to help you get the most of out this essential tool:

Apply filters

Filters allow you to perform searches based on certain criteria. To use a filter, click the '+ Add filter' button.

When you add a filter, you will be able to search and select from a list of data columns and customer events. All of the standard and custom data columns are available, along with all of the standard and custom customer events.

Filter types

There are many different types of filters in the customer directory. The filters are specific to the type of data that is being filtered. For example, if you select the created_at data column, you will notice that all of the filter options are related to dates, with the typical 'is before' and 'is after', along with more advances options like 'on month of year' or 'more than x years ago' . If you select the email data column, you will notice that the filter options are specific to email addresses, with options like 'domain equals'

Once you have selected your desired filter, click the 'Done' button and the app will perform a search.

Multiple filters & chaining

You can easily apply multiple filters at once when searching through the list of customers. This is especially helpful if you are wanting to filter by a certain range of data or reference multiple different data points at once.

  • To group two or more filters together, click the '+' button to the right of an active filter to configure the next filter. This concept is called chaining, and it's useful if you want to group a certain set of filters together.
  • To create a separate filter, click the '+ Add filter' button. This allows you to create a separate filter that is not part of a group.

When using multiple filters, you can apply conditional logic using "and" & "or" operators. Simple click on the operator to toggle between the two options.

Segment customers

Segments allow you to save a filter or set of filters for easy reference. In addition to the filters, a segment also saves the data column preferences that have been configured using the data column picker. There is no limit to the amount of segments you can create, and each segment can have it's own unique set of filters & data column preferences.

Creating segments

You can create a segment by clicking the 'Save segment' button, which is found on the top right of the customer directory. When creating a segment, the app will ask you to provide a segment name. This segment name is just for reference purposes - it has no affect on customer data.

When you save a segment, you will notice that a new segment tab will appear next to the "All" tab. Each segment has it's own unique URL, which is helpful if you need to share a segment with another staff member.

Editing segments

You are welcome to update a segment's filters or data column preferences at any time. To update a segment, simply click the 'Save segment' button after making your changes and select the 'Update an existing segment' option.

You can also edit a segments name, by clicking the 'More actions' button from the top of the directory and selecting 'Rename segment'. Notice there is also an option for 'Delete segment' if you wish to remove the segment altogether.

Reprocess segments

There are some cases where you may want to reprocess a segment to update the list of customers.  The app is designed to automatically update your segments whenever a customer record is added or changed, but if you're using some of the app's more advanced filters (like relative date ranges, for example) sometimes it's helpful to forcefully update the segment.

You can reprocess a segment by clicking on the 'More actions' button from the top of the directory and selecting 'Rename segment'. The app will show a dialog to indicate when a segment is processing, and once it's done you'll see a confirmation message.

Configure data columns

By default, the app's directory will display data columns for customer_id,  first_name, last_name, email, phone, created_at, and updated_at. You are welcome to adjust which specific data columns are displayed (or hidden) from the customer list. Simply click on the column icon and the data column picker will appear in a pop-out.

The data column picker also allows you to adjust the directory's display order for the data columns. You can drag and drop the data columns into the order you desire, and the customer list will automatically update once you close the pop-out.

Adjust sorting

You can sort your customers by two important metrics: The date when their account was created, and the date when their account was last updated.

To sort your customers, make sure either at least one of the following data columns is showing on the directory:

  • Created at (created_at) 
  • Updated at (updated_at)

Simply click on the heading for either data column when viewing the list, and the app will automatically sort the customers 👍  

Other functions

  • Access the app's Import & Export tools
  • Access the customer view and edit pages
Did this answer your question?