System updates

We’re experiencing issues that may affect your Square services. We’ll continue to update our status page with more information.

Home>Customer Directory

Get Started With Your Customer Directory

This article will provide a brief overview of the Customer Directory, giving you the basic information you need to get started on advanced features.

How It Works

Square’s Customer Directory is a contact management tool where you can store customer information, view how they interact with your business and engage with them – all in one place.

Customers are added to your directory when sales are made in person or using Square Invoices. You’re also able to manually add or import customers to your directory in bulk.

If a customer pays with cash, cheque or another form of tender that isn’t a credit card, you can still associate their payment with a new or existing customer profile.

Your Customer Directory has filtering options that allow you to view customer information in greater detail. Filters you can apply range from items purchased, payment frequencies, locations visited and more. You can apply filters and view specific data by navigating to the Directory tab in the Customers section of your dashboard > select Filters. Once your filters are applied, click View Customers to see the customers that fall within the criteria set by your filters.

Note: You can apply filters through both your online Square Dashboard and your Point of Sale app. However, not all filters are available through your app at this time. A more comprehensive list of customer filters are available through your online Square dashboard.

Customer Profiles

Square helps your directory grow by creating Instant Profiles from card sales that contain a customer’s basic information. You can then add information customers choose to share with you, for example, their email address or phone number, to enhance these profiles on your own.

By default, customer contact info such as email address, physical address and phone number will be turned on for your team by default if you have assigned custom permission sets. You can give your team the ability to view and edit this information by enabling this permission with Team Management.

Note: Within the customer list in your Square App, you can view customer’s email and phone numbers, without the need to view their profile.

Instant Profiles

Instant Profiles are customer profiles that are automatically created following a transaction. If a customer’s name is collected from their payment card and a matching profile doesn’t already exist within your directory, Square will create an Instant Profile. Future purchases made with that card will update the customer’s profile with new transaction details and other activity with your business.

Instant Profiles appear in the Instant Profile group in your Directory and can be filtered by using the creation source filter and selecting Instant profile (via payment).


You can create customer profiles individually and in bulk using a CSV import to your online Square Dashboard.

Customer profiles include the following sections:

  • Actions:

    • Send Message: Allows you to send the customer an email using Direct Messaging. Note: This feature is not intended to send unsolicited marketing communications.

    • Edit Customer: Allows you to add and update information for the selected profile.

    • Actions Menu: Click the 3-dotted icon to Add Card, Merge with another Customer, Upload File and Delete Customer.

  • Personal Information: Save and view a customer’s name along with other information the customer chooses to provide, including their contact information, address, birthday and any information from custom fields.

  • Cards on File: Securely store a customer’s payment card information for future payments.

  • Loyalty: If you’re using Square Loyalty, you’ll be able to view a customer’s status and activity, along with the ability to adjust stars, manage linked cards and update their loyalty phone number.

  • Appointments: If you’re using Square Appointments, you’ll be able to view upcoming and past appointments, along with the ability to book future appointments for a client.

  • Buyer Summary: View customer details, including their average spend, total visits and frequency.

  • Coupons and Rewards: View and manually expire any coupons and rewards associated with a customer.

  • Activity: View the customer’s activity at your business, including purchases, Feedback sent about your business, Square Loyalty activity earned and Square Marketing campaigns received.

Customer Groups at a Glance

Term Definition
All Customers This group represents all of the customers saved in your directory.
Instant Profiles Square automatically creates records for any customer that makes a purchase at your business with a credit or debit card. These customer records will, at minimum, include the first and last name shown on their payment card and that customer’s payment history. You won’t always be able to see your customers’ email addresses for these types of profiles, but you can send them an email through Direct Messaging from your Directory. Learn more about our Privacy and Security Policy.
Subscribed Customers Subscribed Customers are the people in your directory that you can contact by email. This list combines customers you may have imported or added that have email addresses, profiles created via Square Invoices and customers that Square has added based on their engagement with your business. Square automatically adds profiles to your Subscribed Customers group when a customer: - Visits your business at least once in the last 12 months, - Pays with a credit or debit card; or - Elects to receive a digital receipt via email. You will only be able to see customers’ email addresses when the customer enters it through email collection tools, or by entering it directly to their customer profile. In some instances, a customer may be Subscribed because their email address was collected through a digital receipt. In these instances, you will not be able to see the email addresses for those customers, but you can send them an email using Direct Messaging from your Directory. Learn more about our Privacy and Security Policy.
Smart Groups Categories used to automatically group your customers based on their visit frequency or engagement with your business. Smart Groups are dynamic, and the list of customers within them may change over time as customers meet the criteria for the group. Two smart groups are included by default in your Customer Directory: Regulars and Lapsed customers. Using filters, you can create customized Smart Groups that meet the criteria of your choosing.
Regulars Group A Smart Group that includes your most loyal, frequent customers. By default, this group is set to collect customers who've visited your business three times in the last six months. You can edit the settings of this group by clicking Actions > Edit Group in your directory.
Lapsed Group A Smart Group that includes customers who were Regulars, but haven't visited in the last six weeks. You can edit the settings of this group by clicking Actions > Edit Group in your directory.

Now that you have an understanding of how profiles work, learn how to manage customer profiles in your directory.

When using Square’s Team Management service, you can assign roles and permissions to your team members so they can take action in your Customer Directory. Actions your team members can take range from creating customer profiles, merging duplicate profiles in bulk and more. You can learn how to getting started with Team Management and see which ccustom permission sets you can assign your team in our Support Centre.

Learn more about: Customer Directory

Can't find what you need?