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 Management

Manage Your Customer Directory Online

Create and enhance existing customer profiles in your directory so you always have their information on hand and know exactly how they interact with your business.

Add Customers

Manually Add Customers

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 payment card numbers or sensitive health information.

To add customers to your directory:

  1. Go to Customers in your online Square Dashboard > click Directory.

  2. Click Create Customer.

  3. Enter your customer’s information and click Save.

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

Clients who book services with your business using Square Appointments, are enrolled in your Square Loyalty program and are charged using Square Invoices are automatically added to your Customer Directory.

You’re also able to add customers from the Square Point of Sale app. Learn more about managing your Customer Directory from the Square app.

Import Customers

From your online Square Dashboard, you can also upload customer profiles in bulk. Use the preferred data formats listed below to help minimise errors and ensure your data is imported successfully. Read more about the importing customers online guidelines.

Data Preferred Format
Dates Preferred formats are YYYY-MM-DD and MM-DD-YYYY.
Birthday Preferred formats are MM-DD, YYYY-MM-DD, and MM-DD-YYYY.
Phone Number Preferred format includes the AU country code before the number (+61 for mobile or +613 for landline). A country code will be added to all phone numbers without a country code.
Address To make sure your address is entered in the correct format, be sure to separate each part of your address into a different column and correctly match each part of your address to the correct field.
Toggle/Boolean Preferred format is yes/no or true/false.
Numeric Both integers and fractional numbers are supported.
Email Subscription Status Preferred format is subscribed*/unsubscribed/unknown.

*With Square Marketing, you can send a marketing email to promote your business to subscribed customers. A subscribed customer is a customer that has provided explicit consent to receive marketing emails from your business. 

If you’ve collected customer email addresses through Square from (but not limited to) sending digital receipts, Invoices, Appointments or Loyalty – the customer cannot receive Square Marketing email campaigns unless:

  • You’ve separately collected and recorded the customer’s explicit consent,

  • You’ve manually imported an existing database of customers who have consented to receive marketing emails from your business, or

  • Your customer has used one of Square’s customer information collection tools.

📌 When importing email addresses via CSV upload, you should set an opt-in status for each email you’re importing by creating a separate status column titled Email Subscription Status. Note: If you download and use the Customer Import CSV Template from your Square Dashboard, this column will already be present.
📌 You can set the status of the email address to Subscribed, Unsubscribed or Unknown. Emails marked as Subscribed will show as available to receive Square Marketing communications from you.
📌 You are responsible for ensuring the customers on your list have given explicit permission to contact them and for compliance with all applicable laws.

Learn more about getting started with Square Marketing.

Import, Edit or Delete Customers

Import Customers

  1. Go Customers on your online Square Dashboard.
  2. Click Directory > Import Customers.
  3. Download the import template or click Skip to drag and drop your customer CSV file into the upload field or click Select it from your computer to upload the file. Click Continue.
  4. All customers added will be within a new group created for your import. 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. Choose a name that will be easy for you to remember the context of the list, like the source of the list or type of customers included in it.
  5. Click Continue.
  6. Confirm your customers’ details 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. Use the “Notes” attribute to keep all the information that doesn’t align with our predefined fields.
  7. Click Import to move this group to your Customer Directory.

Note: If you need to add customer details that don’t currently fit into the default fields, you can add custom fields to your directory before importing contacts.

Edit Customer Profiles Online

  1. From the Customers tab in your online Square Dashboard, click a customer’s name to view their full profile > click Edit.
  2. Make any necessary changes > click Save.

Delete Customer Profiles Online

  1. From the Customers > Directory tab on your online Square Dashboard, click a customer’s name to view their full profile > click •••
  2. Select Delete Customer at the bottom of the drop-down menu.
  3. Read the confirmation and click Delete to continue.

Note: Deleting a Customer Profile will not delete previous transactions. You can always view transactions via your online Square Dashboard.

Duplicates

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. We recommend you review your directory periodically to ensure no duplicates exist.

To check for duplicates and resolve them:

  1. Go to Customers > Directory on your online Square Dashboard.

  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 there may be duplicate entries.

  3. Click Duplicate Suggestion to review the entries flagged as duplicates.

  4. You can choose to Ignore entries that aren’t duplicates, or click Merge or Merge All to combine confirmed duplicates.

Manually Merge Duplicate Customer Profiles

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

  1. Select the duplicate Customer Profile from your directory.

  2. Click ••• > Merge with another Customer.

  3. Search and select the profile you’d like to merge. Click Review.

  4. Carefully review the profiles being combined, as a merge can’t be undone > click Merge.

Note: From the drop-down menu on the main Customers screen of your Square app, you can create a new profile, filter customers, manage groups, add customers to groups, resolve duplicates, merge customers, bulk-delete and view feedback from virtually any screen.

Buyer Status

Upload File Attachments

Add file attachments to your customers’ profiles to keep records, contracts, documents or photos. A customer profile can contain up to 100 files. Merging two customer profiles also merges any files attached to them.

To upload a file:

  1. Select a customer from your directory.

  2. Click ••• > Upload File.

  3. Drag and drop or select a file from your computer. Note: Only upload files you have the rights to use. Files cannot be larger than 20 MB. Supported file types: PDF, JPEG, JPG, GIF or PNG.

  4. Click Upload File.

Once uploaded, click the three-dotted actions menu to the right of the file to Download, Rename, Preview or Delete.

Note: Do not use this feature to upload files containing illegal content or sensitive confidential information, including personal health information or payment card information.

Learn how to upload files to customer profiles from the Square Point of Sale app.

Notes and Reminders

Your Customer Directory lets you add timestamped notes to your customers’ profiles and reminders to revisit those notes in the future.

Add a Note

  1. Select a customer from your directory > click Add Note in the Notes section or from ••• at the bottom of the profile.

  2. Add your note to the field.

  3. If you’d like, set a reminder using the default times or by adding a custom date and time.

  4. Click Save.

If you’ve set a reminder, you’ll receive a push notification on your mobile device via the Square app and an email notification to the address associated with your Square account.

To delete a note, select it from the customer’s profile and click Delete.

Save Payment Cards Online with Card on File

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

  1. Select a customer from your directory > click Add Card in the Cards on File section or from ••• at the bottom of the profile.

  2. Enter the card details and your customer’s email address.

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

  4. 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 or for card on file payments from the Square app.

With Square’s Team Management subscription, you can assign roles and permissions to your team members so they can take action in your Customer Directory and help manage customer profiles. You can learn how to getting started with Team Management and view which custom permission sets you can assign your team.

Now that you have an understanding of how you can create and update customer profiles, learn how to enhance them with information relevant to your business using custom fields in your directory.

Customer Filters

Your Customer Directory stores customer information and provides ways to view how customers interact with your business. By applying filters, you can view in-depth information about your customers, such as the business locations they visit, payment amounts, items purchased and more. To apply filters:

  1. Go to Customers > Directory on your online Square Dashboard.

  2. Click Filters.

  3. Apply filters for the customer data that you wish to view.

  4. Click View Customers to view the customer data.

  5. Once you have a new list of customers, click Save as group and create a Group Name to save the filters as a Smart Group.

  6. If you use Square Marketing, you can send email or text message campaigns to that group of customers.

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

Customer QR Codes

You can increase your line speeds and reduce cashier mistakes by adding a customer to a sale with a QR code. All you need are the items listed below:

  • Customer reference ID in Directory.

  • A supported barcode scanner that can scan QR codes on screens (e.g. Honeywell Xenon 1900). Note: Test your scanner for on-screen scanning first.

  • Square POS on iOS tablet, Android tablet or Register.

Note: This feature is not available on Square for Restaurants, Square for Retail or Square Appointments at this time.

Learn more about identifying customers at your counter with QR codes.

Learn more about: Customer Engagement

Can't find what you need?