All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support

Update existing records and tag what you import

Turn on updating existing records and choose one matching field, so matching records are updated and the rest are created. You can tag every imported record, and choose to skip rows with errors or stop at them.

4 min

Steps

1
On the Map Fields step, turn on Update existing records.
2
In Match by, choose the field, such as mobile or email.
3
Under Add a tag, choose a Tag field and a Tag if you want to tag every imported record.
4
Decide: Skip rows with errors (the default), or stop at the first error.
5
Press Start Import.

If one row matches several records, they’re all updated. Make sure the matching field is unique before you start.

How updating works

Mobile numbers are matched by digits only; email and text ignore letter case.

Only the columns you matched are updated. The assignee and created date of existing records don’t change. Rows that don’t match are created as new records.

Tagging

The tag is added to every created or updated record. If the tag doesn’t exist, it’s created once.

Skipping rows with errors

On: the valid rows are imported and the rows with errors are logged. Off: the import stops at the first row with an error.

If something goes wrong

What you see
Why
What to do
“A matching field is required when updating existing records is on”
You didn’t choose a matching field.
Choose a field.
“The field isn’t a tags field”
You chose a field of another type for the tag.
Choose a tags field.
Duplicate records after the import
You didn’t turn on updating existing records.
Turn it on, and set up the duplicate rule.

A real example

Basma Clinics
The situation

Updating the insurance numbers of 900 existing patients.

What they did
  1. A file with only the mobile and insurance number columns.
  2. Update existing records by mobile, with the tag “Insurance update 2026”.
The result

Only the insurance number was updated, with no other data changed, and the tag made the updated patients easy to filter.

A made-up company, to show the idea. The numbers are rounded.

Good to know

Only one matching field.
Tagging needs a field of the tags type.
Did this guide solve it?
If not, we’ll ask what was missing.
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.