How do I tag customers in Marsello?
How do I tag customers in Marsello?
Organize and manage customers with tags. Manually tag individuals or groups to build custom segments.
🏷️ Tagging customers for segmenting purposes is unlocked on the Loyalty Accelerate plan.
Customer tags in Marsello make it easy to organise your audience, build targeted segments, and personalise your marketing. In this guide, you'll learn how to add a tag to an individual customer, bulk tag multiple customers using a CSV import upload, and use those tags to create custom segments for campaigns and automations.
Bulk tagging allows you to apply tags to multiple customer profiles simultaneously, saving time and ensuring consistency. This is particularly useful for organizing and segmenting large customer lists efficiently.
How do I tag an individual customer in Marsello?
You can tag individual customers to help organize and segment your customer list in Marsello.
- In your Marsello admin, navigate to Customers > All Customers and search for the customer by name or email address
- Click the customer's name to open their profile.
- Under the details section, select the edit link.This will open a pop-up where you can manually add a tag to the customer's account.

- Under Custom tags, click into the text box and enter your desired Tag Name

- Click Save.
The tag will appear on the customer’s profile and can be used for segmentation and automations.
How do I tag a group of customers in Marsello?
You can bulk tag a group of customers by uploading a CSV file using Marsello’s Update existing customers feature.
⚠️ Important: Before you get started, please note this process:
- Only updates the fields you select. If you're only adding a tag, select Tags and skip Points and VIP tier entirely — no placeholder Points column needed
- Matches customers using an identifier you choose: Email, Mobile, Custom/Integration ID, LoyaltyApi ID, or Marsello ExportID
-
You will need a .CSV file containing your customer data
- Does not create new customer profiles — it only updates customers who already exist in Marsello. Rows that don't match an existing customer will fail with a reason. Rows that match more than one customer will also fail.
-
A maximum of 100,000 customers can be updated at one time
Prepare your .CSV file for import
To ensure that your customer list is successfully imported into Marsello, it is important to update your CSV file format following the below steps:
1. Open the .CSV file in a spreadsheet program (e.g., Excel, Google Sheets).
2. Keep only the following columns:
- First Name (required)
- Last Name
- Your chosen matching identifier — Email, Mobile, Custom/Integration ID, LoyaltyApi ID, or Marsello ExportID
- Points Balance — only include this column if you're also updating points balances in this import
| Column name | Required? | Notes |
| First name | Yes | If missing, use a placeholder like "there" or "BrandName fan". |
| Last name | No | |
| Chosen matching identifier | Yes | Enter email, mobile (international format), Custom/integration ID, Loyalty API ID, or Marsello ExportID |
| Points balance | Yes | Enter 0 if no points |
Your final template should look like this:

3. Save your file as a .CSV file

📝 Note:
- Only import include valid email addresses and mobile numbers.
- Mobile numbers must include the country code and contain no spaces or special characters. Example: +14165550000
- If you don't have a mobile number, leave the field blank If you're matching by mobile, every row needs a mobile number. Rows without one will fail.
💡 Tip: To save your file as a CSV, use Export or Download as CSV in your spreadsheet tool.
4. If you're also updating points balances in this import, check your Points column amounts for accuracy. If you're only adding a tag, you can skip this.
Import your data and tag customers in Marsello
1. In your Marsello dashboard, go to Customers > All customers. Click the Manage Customer List dropdown and select Update existing customers.
2. In the pop-up, choose which fields to update. Select Tags (and Points or VIP tier, if you're updating those in the same upload). At least one field is required.

3. Select the identifier you'll use to match customers: Email, Mobile, Custom/Integration ID, LoyaltyApi ID, or Marsello ExportID.
If you select Mobile, you'll see a reminder to format numbers correctly — include the country code, e.g. +14165550000.

💡 Tip: If you also selected Points, choose how points should be applied
- Add imported points to customers' points balance — if you have your points column set as 0's, no points will be added.
- Replace customers' current points balances with the imported points balance — if you have your points column set as 0's, all customers will have their points reset to 0.
.png?width=580&height=142&name=customer-import-step-02-initial-modal-01%201%20(2).png)
If you're only adding a tag, skip this step.
4. Add the custom tag you want to apply for segmenting purposes A default tag name (with the date and time of the import) is pre-filled — keep it or enter your own.
5. Click Upload CSV
Upload your file. You'll see an upload template showing only the fields you selected. Choose your upload method:
- Drag and drop your formatted .CSV file.
- Click the file box to browse and upload.
- Copy/paste data directly from your CSV into the upload table.

⚠️ Important: By importing customers, you confirm all customers being updated accept marketing. Remove any who don't from your CSV before uploading.
-
Ensure the first row contains your column headers (e.g., First Name, Last Name, [your identifier])
-
Select the header row and click Next.

7. Map Your Columns
-
Match each CSV column to the correct Marsello field.
-
Use the dropdown menus to adjust mappings if needed.
-
Click Next.

8. Verify Data
-
Check that all details are in the correct fields (e.g., first names in First Name, your identifier in the matching field).
-
Fix any errors in-app within the table or offline by selecting export.

Fix errors in-app
-
Use the Invalid tab to quickly find issues in-app. Any row that has an error in it will appear in red. Here you will be able to click into the field with the error and make the update.

Fix errors via export
-
Click export to download your data as an xlsx file. Within your downloaded file, any row that has an error in it will appear in red. You will be able to hover over the row to see a detailed description of the error.

💡Quick Tip: Use Excel or upload your file into Google Sheets to filter by color in each column to show invalid rows only. Click into each field with the error and make the update.

- When your file is ready, close the previous import and upload your new file. Complete the upload and mapping steps. This will allow you to cleanly import your updated file.
⚠️ Important: Common invalid row causes
- Blank rows
- Missing First Name, Last Name, or identifier
- First name doesn't start with a letter or contains symbols (#$^&)
- Invalid email format
- Mobile number not in international format (+ followed by the country code, e.g. +6427123123)
- Extra whitespaces at the end of the email or mobile number
Submit update
1. Click Submit. A confirmation window shows what was uploaded and how each column was mapped. Review the details, then click Upload CSV File to start the update.
.png?width=625&height=523&name=Screenshot%202026-10-12%20at%203.00.08%20PM%20(1).png)
The update runs in the background and may take up to 24 hours, depending on the size of your file. When it’s finished, you’ll receive an import report by email listing any rows that failed and why.
A row fails if it doesn’t match an existing customer, or if it matches more than one customer.

⏳ Imports may take up to 24 hours, depending on file size.
How do I use customer tags to create a custom segment?
You can use customer tags to create custom segments, making it easy to target specific customers in campaigns, automations, and messages.
1. In your Marsello admin, navigate to Customers > Segments and click Create Segment
2. Name your custom segment
3. Click the First Name drop-down to add your first segment condition
4. In the Select Condition drop-down, select Custom Tags
5. Next to the Custom Tags field, select is as the operator
6. Then, select your custom tag
💡 Optional Step: Add more conditions Click Add Condition to add another condition to your segment.
-
Add as many conditions as you'd like.
-
Use AND / OR to control how conditions are applied:
-
AND requires customers to meet all conditions
-
OR requires customers to meet at least one condition
-
7.Click Preview Segment to see a sample of the customers who meet your segment conditions
📝 Note: Only customers who have accepted marketing will populate into your custom segments.
8. Click Create Segment
Your segment will then be created and added to your Segments. It will also appear as an option when choosing your audience for Email or SMS Campaigns as well as in Automated Emails/SMS messages.