A Meta customer list template is a spreadsheet or CSV layout for organizing customer identifiers before using them to create a Custom Audience. Start with the blank template below, include only identifiers you are permitted to use, and map each column to the matching field in Meta’s audience setup.
What a Meta Customer List Is For
A customer list is a set of identifiers that a business already has, such as email addresses or phone numbers. When you create a customer-list Custom Audience, Meta attempts to match those details with accounts on its services. You can then use an eligible audience for advertising, subject to Meta’s tools, requirements, and policies. A list is not a general contact-import feature, and uploading it does not guarantee that every person will match or see an ad.
The spreadsheet is a way to prepare and organize the data; it is not itself the audience. In Meta Ads Manager, the audience creation flow lets you select a customer-list source, upload a file or use an available connection, and identify what each column represents. Labels and screens can change, so follow the field options shown in your account rather than assuming every file header will be recognized automatically.
This template is deliberately flexible. Not every campaign needs every field, and adding more personal details is not automatically helpful. A small, clean file with a useful identifier is generally easier to check than a large export full of unrelated or outdated information.
Meta Customer List Template
Blank template: Copy the headers into a spreadsheet, add one person per row, and leave unavailable fields empty. Remove any columns you are not using before exporting.
| phone | first_name | last_name | city | state | postal_code | country | external_id | |
|---|---|---|---|---|---|---|---|---|
Fictional sample: This example is illustrative only; the contact details are not a real customer record.
| phone | first_name | last_name | city | state | postal_code | country | external_id | |
|---|---|---|---|---|---|---|---|---|
| avery.sample@example.com | +1 202-555-0147 | Avery | Sample | Exampleville | CA | 90000 | US | DEMO-001 |
Which Identifiers Should You Include?
Use fields that you actually have a valid reason and permission to use. Email and phone are common identifiers, while names and location details can provide additional matching information when supported by the upload flow. An external ID can be a business’s own stable customer reference, but it should not be treated as a substitute for a recognized matching identifier unless Meta’s current interface accepts it for that purpose.
- Email: Use the address associated with the customer record. Remove accidental spaces and check for obvious typing errors.
- Phone: Include the country code when available, and use a consistent format throughout the file.
- Name and location: Separate first and last names if you have them separately. Keep city, state or region, postal code, and country in their own columns.
- Other fields: Add another identifier only if the current upload screen offers a matching field for it and you are authorized to use it.
Do not fill gaps by guessing. For example, do not infer a customer’s location from an old shipping address or invent a phone number to make every row look complete. A blank cell is clearer than a made-up value, and a correct identifier is more useful than several unreliable ones.
File and Column Formatting
A spreadsheet is convenient for editing, but the upload flow commonly accepts a delimited text file such as CSV or TXT; check the formats offered in your account before exporting. CSV means comma-separated values. If a field contains a comma, such as a company or street name, the export must quote or otherwise correctly handle that value so it does not shift into the next column. A quick way to check is to reopen the exported file in a spreadsheet and confirm that each value remains under its intended header.
Use one row per person or customer record and one column per type of identifier. Include a clear header row, avoid merged cells, and remove report titles, totals, notes, and empty columns above or beside the data. Keep the same type of information in the same column. For example, do not put email addresses and phone numbers together in one cell unless the upload flow specifically asks for that format.
Standardize values before export. Trim spaces at the start and end of email addresses, use consistent country and region entries, and check that phone numbers have not lost leading characters during spreadsheet conversion. Choose a date format only if you are including a date field that the upload flow supports; do not add dates just because the source system contains them. Meta’s mapping step may let you identify or correct a column’s meaning, but good headers make mistakes less likely.
Preparing and Uploading the List
A careful preparation process makes the upload easier to review and reduces avoidable matching errors. The precise controls can vary, but the overall steps are straightforward:
- Confirm the source. Identify where the records came from and why the business is entitled to use them for this advertising purpose.
- Limit the data. Keep only the fields needed for matching and remove unrelated notes or sensitive details.
- Clean and deduplicate. Correct formatting problems, remove duplicate records where practical, and exclude records that should no longer be used.
- Export a supported file. Save the prepared data in a format offered by the upload flow, with headers in the first row.
- Upload and map fields. Choose the customer-list audience option, provide the file, and review how Meta identifies each column. Correct any unmapped or incorrectly mapped fields.
- Review the result. Check the audience status and any warnings in the account. Do not assume a successful file upload means every row matched or that the audience is ready for every use.
Keep the original working file in an appropriately restricted location and avoid creating extra copies for convenience. If you need a repeatable process, document the source, date of preparation, columns included, and person responsible for the upload without putting unnecessary personal data into the notes.
How Matching Works and What to Expect
Meta compares the identifiers provided in the list with information associated with accounts on its services. A match depends on the identifier being usable and sufficiently consistent with the information Meta can recognize. A person may not match because they used a different email or phone number, changed details, or do not have a corresponding account. A match rate is therefore not a measure of how many customers exist in your source database.
Do not expect the uploaded audience size to equal the number of spreadsheet rows. Duplicate entries, invalid values, formatting differences, and unmatched records can all affect the result. Nor does audience size reveal which specific person matched: the platform does not provide a customer-by-customer match report through the ordinary audience workflow. Use the audience status and available summary information to troubleshoot at an aggregate level.
You may hear that customer-list identifiers are “hashed.” Hashing is a technical transformation used in handling identifiers, but it does not make information anonymous in every context or remove your responsibility for how the data was collected and used. Follow the instructions in the upload method you choose. Do not manually hash values unless the particular workflow explicitly requires it, because pre-hashing can prevent the system from processing the fields as expected.
Privacy, Permission, and Data Safety
Before uploading, consider whether the people on the list were informed about the relevant data use and whether your organization has the necessary rights or permissions. Meta’s customer-list terms and advertising policies apply, and privacy requirements may also depend on where the people live and how the records were collected. Do not upload information obtained from an unauthorized source, or use a list in a way that conflicts with the commitments made when collecting it.
Use the minimum data necessary and keep access to the file limited to people who need it. Avoid placing sensitive personal information in the list or adding data categories simply because they are available in a customer database. Apply your organization’s retention and deletion practices to the source file and any working copies. If you are unsure whether a particular data source or use is permitted, ask a qualified privacy or legal professional rather than treating this template as legal advice.
Also take ordinary file-security precautions: use approved storage, avoid sending customer files through unsecured channels, and check that you selected the intended file before uploading. A spreadsheet can retain hidden tabs, comments, or extra columns, so inspect the complete workbook and export before sharing it.
Common Upload Problems
Most basic errors come from formatting or field selection rather than from the template itself. If an upload is rejected or the audience seems unexpectedly small, review the file and the account’s displayed warnings before rebuilding it.
- Columns are not recognized: Confirm that the first row contains headers and map each field manually when the interface offers that option.
- Values appear in the wrong fields: Check the CSV export for commas, quotation marks, extra delimiters, or spreadsheet formatting that shifted columns.
- Phone matching looks weak: Check country codes, inconsistent punctuation, missing digits, and whether numbers were converted or truncated during export.
- Many records are duplicates or incomplete: Remove repeated rows where practical and exclude entries with no usable identifier rather than filling in guessed information.
- The audience is still processing or unavailable: Follow the status shown in the account and allow the platform’s process to complete. A processing message is not the same as a confirmed error.
Change one thing at a time when troubleshooting. For instance, first check headers and mapping, then review formatting, then evaluate whether the source identifiers are current. Replacing the entire dataset without identifying the problem can make it harder to know what fixed the issue.
When a Customer List Is the Right Choice
A customer list can be useful when you want to reach eligible existing customers or build an audience based on records your organization already holds. It may also support audience strategies that use an existing audience as a starting point, where such options are available and permitted. It is less suitable when you have no properly sourced customer data, when identifiers are stale, or when the intended campaign depends on information you cannot lawfully or appropriately use.
Alternatives include audiences based on activity on your own digital properties or engagement with content, if those options are available in your account and set up with the required permissions and disclosures. These approaches use different signals and are not interchangeable with a customer list. Choose based on the campaign objective and the data you are authorized to use, rather than assuming one audience type is always more effective.
Frequently Asked Questions
Can I upload a customer list with only email addresses?
Usually, a list can be prepared with a single supported identifier, such as email, but matching depends on whether the address corresponds to an account. Use the field mapping offered during upload and do not add inaccurate details merely to make the file larger.
Does every column in the template have to be filled in?
No. The template is a set of optional fields, not a requirement to collect every value. Keep only columns you have and can appropriately use; blank values can remain empty, or you can remove unused columns before export.
Should I hash the customer data before uploading?
Follow the instructions shown for the specific upload method. The standard upload flow may handle identifier processing for you, and hashing the file yourself when it is not requested can interfere with field recognition or matching.
Why is the audience smaller than the number of rows?
Rows may be duplicated, incomplete, outdated, or associated with identifiers that Meta cannot match. The audience count is not expected to be a one-to-one reflection of the spreadsheet, and it does not identify which individual records matched.
Can I use the same list again later?
Whether reuse is appropriate depends on the list’s source, your permissions, the current purpose, and Meta’s rules. Before reusing it, confirm that the records are still suitable and that your organization’s retention and privacy practices allow continued use.