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

The customer directory includes powerful features that allow you to apply multiple filters when viewing your 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 out of this essential tool:

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 can 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.

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 advanced 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.

See here for a guide on how to sort customers by date created.

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

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

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 number of segments you can create, and each segment can have its own unique set of filters & data column preferences.

You can create a segment by adding your desired filters and then 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 effect 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 its own unique URL, which is helpful if you need to share a segment with another staff member.

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 segment's 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.

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 'Refresh 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.

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.

You can sort your customers by two important metrics: (A) The date/time when a customer record was created, and (B) the date/time when a customer record was last updated.

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

Click on a heading for either data column when viewing the list, and the app will automatically sort customers. Descending order is used by default (newest first), but you can change to ascending order (oldest first) by clicking the heading a second time.

There are two ways to delete customer records in the app; via the customer directory and via the customer detail pages.

Remove only from Customer Fields: this option will remove the records from the app, but will not delete them in Shopify. This option is especially useful if you are trying to downsize managed customers to make more room for your customer quota.

Delete from Customer Fields and Shopify: this option will permanently delete the customers from both the app and Shopify.

See the gif below to see how to remove multiple customers from the app:

When viewing a specific customer record, there is an option at the bottom of the page to remove the customer from Customer Fields. This will remove the customer from the app, but not from Shopify: