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.
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:
Go to Customers in your online Square Dashboard > click Directory.
Click Create Customer.
Enter your customer’s information and click Save.
Note: If you are 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.
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.
|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 having a separate status column, titled Email Subscription Status. Note: If you download and use the Customer Import CSV Template from your Square Dashboard, then 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. Please always consult a knowledgeable professional advisor to ensure you are adhering to Australian guidelines.
Learn more about getting started with Square Marketing.
Import, Edit, or Delete Customers
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.
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:
Go to Customers > Directory on your online Square Dashboard.
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.
Click Duplicate Suggestion to review the entries flagged as duplicates.
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:
Select the duplicate Customer Profile from your directory.
Click ••• > Merge with another Customer.
Search and select the profile you’d like to merge. Click Review.
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.
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:
Select a customer from your directory.
Click ••• > Upload File.
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 20MB. Supported file types: PDF, JPEG, JPG, GIF, or PNG.
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.
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
Select a customer from your directory > click Add Note in the Notes section or from ••• at the bottom of the profile.
Add your note to the field.
If you’d like, set a reminder using the default times or by adding a custom date and time.
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 to your directory. Here’s how to link a payment card to a customer profile:
Select a customer from your directory > click Add Card in the Cards on File section or from ••• at the bottom of the profile.
Enter the card details and your customer’s email address.
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.
Note: Make sure to keep authorisation forms on file and store them securely.
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.
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:
Go to Customers > Directory on your online Square Dashboard.
Apply filters for the customer data that you wish to view.
Click View Customers to view the customer data.
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.