With Square’s Customer Directory, you can manage customer information from the Square app or your online Square Dashboard.

Customers are added to your directory every time a sale is made, either in person or from Square Invoices.

Manually Add Customers to Your Directory Online

When adding customers to your directory, make sure their information stays safe – don’t store sensitive or confidential information in the notes field, such as credit card numbers or health information. 

To add Customers to your directory:

  1. Visit Customers in your online Dashboard. 
  2. Click Create Customer.
  3. Enter your customer’s information and click Save.

Import Contacts to Your Directory Online

From your online Square Dashboard, you can also upload customer profiles in bulk. To do so: 

  1. From  Customers, click Import at the top-right corner. 
  2. Drag and drop your customer CSV file into the upload field or click “select it from your computer” to upload the file.

    Note: You must import a CSV file no larger than 0.25 MB. XLS or other file formats will not import successfully.

    Import customer pop-up modal. Drag and drop your customer list here.

  3. Click Continue.
  4. Add this customer CSV file to an existing customer group or create a new group.
    • To add customers to an existing group, click the drop-down menu and select a group from the list.
    • To create a new group, enter a name and select “create new” in the drop-down field. 
  5. Click Continue
  6. Confirm that your customers’ information are in the correct columns. If there are errors, click the drop-down menu to the right of the field and select the correct field. 

    Note: Use the Notes attribute to keep all the information that doesn’t align with our predefined fields.

    After importing your customers, double check their assign fields to make sure all customer information is categorised correctly.

  7. Click Import to move this group to your Customer Directory. 

Note: You can export your CSV from other email marketing tools, such as MailChimp or ConstantContact, and upload the file to your Customer Directory.


Your Customer Directory will identify potential duplicate profiles if two or more customers share the same email address and/or phone number. However, if the profile names are dissimilar or if the two profiles have a different email or phone number, they will not be identified as duplicates. In this case, you can still manually merge the profiles if they happen to be the same customer.

Fix Duplicates

After manually adding customers, or importing customer contact information to your directory, you may end up with duplicate records. Duplicate records may incorrectly increase the total number of customers in your directory, and lead to increased pricing for Square Marketing subscriptions. We recommend you review your directory periodically to ensure no duplicates exist.

To check for duplicates and resolve them:

  1. Visit your online Customer Directory.
  2. Within the All Customers group, if multiple records exist with the same email address or phone number, you’ll receive an alert notifying you that there may be duplicate entries.
  3. Click Review All to review the entries flagged as duplicates.
  4. You can choose to Ignore entries that aren’t duplicates, then click Merge All to combine confirmed duplicates.

If our system has not recognised a duplicate, you can manually merge two profiles. To do so:

  1. Select the duplicate Customer Profile.
  2. Click Edit > Merge with another Profile.
  3. Review the profiles being combined, as a merge can’t be undone.
  4. Click Merge.

Edit Your Customer Directory Online

  1. From Customers, click a customer’s name to view their full profile > Edit.
  2. Click Save, or to delete a customer, click Delete at the top of the customer’s profile > Delete Customer.

Save Payment Cards Online with Card on File

Collecting payment from your customers is even easier when their payment cards are saved to your directory. Here’s how to link a payment card to a customer profile:

  1. From Customers, click Directory.
  2. Select a customer > click Actions > Add Card.
  3. Enter the card details and your customer’s email address.
  4. You must have written authorisation from your customer to save their payment card*. Use the provided template form by clicking Download Form and send it to your customer.
  5. Click Save.

*Note: Make sure to keep authorisation forms on file and store them securely.

Learn more about charging a customer’s payment card on file to collect payment for a Square Invoice.