Sometimes the same place ends up on a customer twice: once as Building Department and once as Historic Courthouse, or once with a typo in the street. Merging moves everything from one address to the other and removes the extra one, so the jobs, invoices and equipment are all in one place.

This is for two addresses of the same customer. To combine two customer records, see Finding and merging duplicate customers.

Who can do this

Anyone who can edit customers (owners, admins and dispatchers by default).

Before you start

  • The customer needs at least two addresses, and the one you keep has to be active. An inactive address isn't offered as the one to keep. Mark it active first.
  • A merge can't be undone from the app. Read the review step before you confirm.

Open the address that should go away

  1. Go to Contacts, open the customer and click the Properties tab.
  2. On the address you want to remove, click the ⋯ button.
  3. Choose Merge into another address….
<!-- TODO(shot: /screenshots/customers/merge-two-addresses-menu.webp — address menu on the Properties tab with Merge into another address) -->

Pick the address to keep

The Merge into another address window asks Which address is the same place? Click the address that stays.

Check what moves

The next step shows the two addresses side by side, marked Keep and Goes away, and under What happens a line such as Moves to Historic Courthouse: 5 jobs, 0 estimates, 2 invoices, 3 units.

What you may seeWhat it means
Blank on the kept address, filled in from the other one: …Details the kept address was missing are copied over from the one going away.
Both addresses have a system with the same name, so the moved one is renamedThe moved system gets the other address's name added, so you can tell the two apart.
A message in redThe merge can't go ahead yet. See When it won't merge.

Click Continue.

<!-- TODO(shot: /screenshots/customers/merge-two-addresses-review.webp — review step with Keep and Goes away cards and the What happens list) -->

Confirm

  1. Read the line at the top: Keep [address], remove [address].
  2. Type MERGE in the box.
  3. Click Merge addresses. You'll see Merged into [address].

What happens

  • Jobs, estimates, invoices, equipment, systems, memberships and site contacts on the removed address move to the one you kept.
  • The removed address is taken off the customer.

When it won't merge

MessageWhat to do
These unit asset IDs are on both addresses: …Two units would end up with the same asset ID at one address. Change the asset ID on one of them, then merge again. See Asset IDs and custom equipment types.
The address you are keeping is inactive. Reactivate it first, or keep the other address.Choose Mark active on that address, or keep the other one.
The address you are removing is linked to a QuickBooks sub-customer, so it can't be merged away. Keep that address instead, or ask support to unlink it from QuickBooks first.Start the merge from the other address, so the linked one is the one you keep.

Good to know

  • Merge into another address… only shows when the customer has another active address to merge into.
  • To move a single job to another address without merging, open the job, click ⋯ at the top and choose Change address.
  • If a merge was done by mistake, contact support. Every change is recorded.
<!-- labels: components/customers/profile/address-trays.tsx ("Merge into another address…"); components/customers/merge-property-dialog.tsx ("Merge into another address", "Which address is the same place?", "Keep", "Goes away", "What happens", "Continue", "Type MERGE to confirm", "Merge addresses", "Merged into …"); lib/customers/property-merge.ts (moving sentence + refusal messages) -->