For the complete documentation index, see llms.txt. This page is also available as Markdown.

Edit Properties Wizard

This wizard applies the same property change to many users at once. It is reached from the Edit Properties action on the Users page, which carries the selected users across. More users can be added once inside, without going back to the Users page.

The selection is handed over in session storage and cleared as soon as the wizard reads it. Reloading the page loses the list and leaves you with nothing to update, so go back to the Users page and start the action again rather than refreshing.

1

Review Users

The users carried over from the Users page are listed with their display name, user principal name, job title and department. The Remove from List row action drops a user from the run, which is the moment to catch anyone caught by an over-broad selection or filter.

Add users searches for more users to add to the run without going back to the Users page. It only works when a single tenant is clear: either every user already in the list belongs to the same tenant, or a specific tenant (not AllTenants) is selected in the CIPP header. When neither is true, the picker is disabled and CIPP asks you to select a tenant first. Users already in the list are excluded from the picker's results.

The wizard will not continue with an empty list.

2

Select Properties

Properties to update is a multi-select listing everything that can be changed, with a Select All entry at the top. Each property you tick adds its own input below, and the input matches the property: a text box for most, a switch for Show in Address List, a user picker for Manager and Sponsor, and a domain picker for UPN Domain Suffix.

3

Confirmation

The properties and the values you set are listed together, followed by the users the change will be applied to. Submit applies everything in one operation. Once it has run the button becomes Resubmit, and the results appear below it.

Properties

Property
Graph property
Notes

Business Phone

businessPhones

Holds a list in Graph, but the wizard writes the single value entered, replacing any numbers already on the account.

City

city

Company Name

companyName

Country

country

The country name held on the profile. This is not what licences are assigned against, which is Usage Location below.

Department

department

Employee Type

employeeType

Free text, commonly used for values such as Employee, Contractor or Vendor.

Fax Number

faxNumber

Job Title

jobTitle

Manager

manager

A directory relationship rather than a property, so it is set in a separate operation from the rest of the patch and reports its own result.

Mobile Phone

mobilePhone

Office Location

officeLocation

Postal Code

postalCode

Preferred Data Location

preferredDataLocation

Only has an effect in a multi-geo tenant, where it decides which region the user's data is stored in.

Preferred Language

preferredLanguage

A language code such as en-GB, not a language name.

Show in Address List

showInAddressList

A switch rather than a text value. See the note below on setting it to No.

Sponsor

sponsor

A directory relationship, handled the same way as Manager.

State/Province

state

Street Address

streetAddress

Usage Location

usageLocation

A two-letter country code such as GB or US. This is the field licence assignment depends on, so a wrong value blocks licensing rather than just looking untidy.

UPN Domain Suffix

userPrincipalName

Changes the part of the sign-in name after the @ symbol, keeping each user's existing prefix. Only offered when every selected user belongs to the same tenant.

Custom data attributes mapped for manual entry against users also appear in the list, labelled (Custom), and write to the attribute they are mapped to. Attributes that hold more than one value are left out, as the wizard writes a single value to every selected user.

When the selection spans tenants, the users are grouped by tenant and updated tenant by tenant. Two limits follow from that. UPN Domain Suffix is withdrawn from the property list entirely, since a domain from one tenant means nothing in another. Manager and Sponsor stay available, but their picker only lists users from the first tenant in the selection, and the assignment will only succeed where an account with that name also exists in the other tenants. The wizard warns about both on screen.


Feature Requests / Ideas

We value your feedback and ideas. Please raise any feature requests on GitHub.

Last updated

Was this helpful?