Address Management is a database of your city's addresses, used two ways: to control which permit types and permissions someone is even eligible for based on where they live, and to cap how many permits of a given type one address can hold.

This is where Staff view and maintain the address records that both eligibility matching and per-address limits are built on.

Permits → Address Management loads pre-populated with every saved address. Each row in the table shows the address, how many permissions it's mapped to, whether it's Verified, when it was last updated, and any notes. Search supports fuzzy, partial matching, but only returns exact case matches.

Verified shows a green check once the address has been validated against the USPS database. An address without a green check can still be saved, searched, and have permissions assigned to it, being unverified doesn't block anything on its own.

The Add Address button opens a drawer for the standard fields (street 1, street 2, city, state, ZIP, country) plus a searchable, multi-select list of permissions to associate. No permission is required to save an address. The notes field on an address is a single field that gets overwritten each time it's edited, there's no history of earlier notes or who wrote them.

Pro tip: If address matching on CMRpay looks off, check first whether an apartment or unit number got typed into street 1 instead of street 2. Line 1 and line 2 are matched separately, and a unit number jammed into line 1 is the most common reason matching looks broken when the address itself is otherwise correct.

Editing an existing address works the same way. Accessed from the row's Action → Edit button, a drawer will open that is pre-filled with its current details and editable fields. Deleting a single address is also available from that menu and requires a confirmation, since it can't be undone. Deleting several at once is available separately, via checkboxes on the table.

For programs using address management, an applicant's first step on CMRpay is selecting their address from a searchable dropdown. The system resolves which permit types and permissions that address is eligible for, and only displays those options to the end user. This matters most for cities with many small permission areas under one permit type. For example: one residential permit type split across dozens of neighborhood permissions. Without an address-first flow, an applicant would need to already know which neighborhood name applies to them. With it, they just enter their address and the system figures out the rest.

Pro tip: If a permit type isn't available for an address that seems like it should qualify, it is likely that the permission was added to address records without also being added to the permit type . If you suspect this is the issue, ask Passport Support to resolve.

Removing a permission from an address does not affect permits already sold against it. It only stops new applications from resolving to that permission going forward. If someone already has a permit tied to that address and permission, removing the permission doesn't touch their existing permit or their ability to renew it. The permit just keeps the permission it was issued with, whether or not the address still carries it. In this scenario, Staff would need to cancel and reissue the permit to ensure the permissions are up to date.

An address can be capped at a maximum number of permits of a given type, separate from any citywide cap. This is often paired with tiered pricing, where the second or third permit at the same address costs more than the first.

The limit is based on a specific address record, not a street or a building. Two different apartments in the same building are two different address records, each with its own independent count. The limit number itself is global, not customizable address by address.

If a permit is using address management, editing the address on an existing permit does not automatically move it to a new permission or update any limits tied to that address. There's a warning banner in the edit drawer for this, but staff can still save over the address fields if they choose to.

The correct approach is to cancel the existing permit and issue a new one at the new address, so everything updates the way it should.

Bulk loading or cleaning up a batch of addresses is available through Passport Support if needed, reach out to them rather than using the CSV import tools on this page directly.

Address Management does two separate jobs with the same underlying data, it drives which permit types and permissions someone's address makes them eligible for, and it caps how many permits of a type one address can hold. Staff manage the address records directly, and since eligibility depends on a permission existing on both the address and the permit type, keeping those two sides in sync is the main thing to watch. Reach out to Passport Support for bulk changes or anything this article doesn't cover.