Users, Display Names and Avatars
Everyone who signs in has a user account. Orchard Core gives you the user list, where you add people, reset passwords and give them roles. CrestApps adds a display name, so screens show John Smith instead of jsmith, and an avatar, a picture for each person. Use them when agents, supervisors and customers' records should show real names rather than sign-in names.
| Menu | Access Control > Users; Settings > User Display Name; Settings > User Avatars |
| Permission | Manage users (accounts); Manage the user display name settings; Manage the avatar settings |
| Feature | Users (Orchard Core); User Display Name; User Avatar |
What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.
Add a user and give them access
- Open Access Control > Users and click Add User.
- Fill in the User name and Email. Phone Number is optional and must start with the country code. For the Password, type one, or click Generate password and Copy password to pass it on. Tick the roles the person needs. The roles decide what the person can see and do. See Roles and Permissions.
- If the display name boxes are shown, fill them in (see Set a person's name).
- Save the user.
Each row of the user list shows the user name, the email address and a badge for each role. Unconfirmed means the person has not confirmed their email address yet. The Search box, and the Role, Show and Sort menus, narrow and order the list. The Actions menu on a row offers Change password, Disable, Confirm email and Delete.
Creating accounts, passwords, sign-in and registration are standard Orchard Core screens. See the Orchard Core Users documentation for those.
To change what someone can do later, edit their user and change their roles. You rarely need to change a role itself.
Choose how names are shown
Open Settings > User Display Name. It decides how a person's name is built everywhere the site shows a user.
| Field | What it does |
|---|---|
| Display name format | How the name is built. Username (the default) shows the sign-in name. Display name shows a free-text name each person has. First Middle Last name shows John A Smith. Last, First Middle name shows Smith, John A. Custom format uses a pattern you type in Liquid format. |
| Liquid format | Only for Custom format. A pattern such as {{ FirstName }} {{ LastName }}. Ask a developer if you need something more advanced. |
| Display name | Whether the user editor has a Display Name box: Don't use, Optional or Required. |
| First name, Middle name, Last name | The same three choices for each name box. A middle name is only part of the name when Middle name is not set to Don't use. |
Click Save. When a person has no name filled in, the site shows their user name instead.
Use this when you want full names everywhere: pick First Middle Last name and set First name and Last name to Required, so every account you add or edit must carry a full name.
The screencast sets the format to First Middle Last name, fills in the names on a user, and then shows the author badge in the content list changing from the user name to the full name.
Where the name appears
- The user menu at the top of the admin screens.
- Author and owner badges in content lists.
- User pickers, such as the Owner Name box on content items and user fields on content types.
- Searching Access Control > Users: typing a name finds people by user name, display name, first, middle or last name.
Set a person's name
- Open Access Control > Users and edit the user.
- Fill in the Display Name, First Name, Middle Name and Last Name boxes. Only the boxes that are not set to Don't use are shown, and boxes set to Required must be filled in before you can save.
- Save the user.
Only people who can edit user accounts see and change these boxes. Someone who edits only their own profile cannot change their name; ask your administrator to update it.
Pick a content item's owner by name
When a content type shows the owner box, the Owner Name box becomes a searchable list of users that shows their display names. Click Browse users, type part of a name, and pick the person.
In the content type's Common part settings you can also choose the Permission Defined Editor. It shows the owner box only to people who are allowed to publish the item.
Avatars
Open Settings > User Avatars to set how avatars work, then click Save.
| Field | What it does |
|---|---|
| Require Avatar | Every user must have a picture before their account can be saved. |
| Use default CSS styles | Uses the built-in look for avatars. Leave it ticked unless a developer has styled avatars for your site. |
To give someone a picture, edit the user and use the Avatar box to pick or upload an image from the media library. Only image files are accepted. The box is shown only to people who have the Manage Media permission. The avatar appears next to the person's name in places that show who a user is.
Audiences
An audience is a group of people chosen by rules, such as "everyone in the Field team hired more than 30 days ago". Other features target an audience, so the people in it change as your teams, staff records and roles change. Turn on the User Audiences feature, then open Content > User Audiences.
The list shows the audiences you define and the ones features define (marked Defined by a feature, which you can't edit). Click People on any of them to see who is in it today.
To add one, click Add audience and fill in:
| Field | What it does |
|---|---|
| Name | The name people see. |
| Technical name | The name other features keep to find the audience. It can't change after you save. |
| Description | What the audience is for. |
| Who is in it | People who match every rule, or People who match any rule. |
| Rules | Pick a rule, then the values it matches; within one rule a person matches any value chosen. Click Add rule for another, or the bin to remove one. |
The rules you can pick depend on the features that are on: In a role, Member of a team or its sub-teams, Hired at least some days ago, Employment type, Holds a skill, Holds a valid certification, Enrolled in a course and Cohort member. Click Save, then People to check the audience holds who you expect.
Cohorts
A cohort is a named group of people you keep by hand, such as "2026 new hires" or "Warehouse supervisors". Where an audience follows rules, a cohort holds exactly the people you add, so use it for a group no rule describes. Turn on the Cohorts feature, then open Content > Cohorts.
-
Click Add cohort, give it a Name (each cohort has its own) and, if you like, a Description, and click Save.
-
On the cohort's people page, add people:
- People: search by name, user name or e-mail and choose one or more.
- Many at once: paste user names or e-mail addresses, one per line or separated by commas.
Click Add to cohort. People already in it are skipped, and the page tells you about any name that matches no user.
-
To take someone out, click Remove on their row.
The list shows how many people each cohort holds. Edit renames a cohort; Delete, in the row's menu, deletes it with its list of people. A cohort a course or learning path is linked to can't be deleted until you unlink it. Someone whose account is deleted leaves every cohort.
To target a cohort from a feature that uses audiences, such as required learning, add an audience with the Cohort member rule and pick the cohorts. Courses and learning paths can enroll a cohort's people directly: see Enroll a cohort.
Sign in with an email code
With the Sign in with an email code feature on, the login page offers Email me a sign-in code instead. The user clicks Email me a code after entering their email, and gets a six-digit code, which they type on the next page to sign in, without a password.
- A code works once, for ten minutes and five tries. A new code replaces the last one.
- A few codes can be sent to an email, and from one visitor, every fifteen minutes.
- The page answers the same way whether or not the email has an account, so it never tells anyone who is registered.
- Users who are disabled, locked out or use two-factor authentication sign in with their password as before.
Your site's email must be set up in Orchard Core's email settings for the codes to be sent.