Members are used for registering and authenticating external users of an Umbraco installation (ie. forum members, intranet users and so forth). Unlike with Document Types and Media Types everything is done in the Members section both defining and creating, and editing members. This guide will explain how to define and create members in the backoffice. If you want to work with members using the service APIs, links can be found at the end of document
There is a default Member Type that can be used to create members. You can of course customize it to fit your needs or create your own from scratch.
Creating a member
Go to Members section, click the menu icon next to Members in the member tree and select Member. Members have a number mandatory properties. So aside from filling out the name you will need to fill out Login, Email and Password on the Properties tab before the member can be saved.
There is also a number of default properties on the Membership tab:
Once the member is created and saved you can access it by expanding the members tree and click All Members to get a list view (with real time search) or select the member type to filter by, by selecting it in the Members tree.
Creating a Member Type
You can create your own Member Types and add properties and tabs just as with Document Types.
Go to the Members section, click the menu icon next to Member Types and select Create. Name the new Member Type and click the Create button.
You are now taken to the Member Type editor that is used to define and edit the Memeber Type. It consists of three tabs: Info, Generic Properties and Tabs.
Shows basic information about the Member Type and settings for custom properties.
Name: The name of the Member Type shown in the Member Type tree and when users create a new member.
Alias: Used to Reference the Member Type in code.
Icon: The icon is shown in the Members list view. If the are more than one Member Type choosing different icons will help identify members easily.
Description: The description is shown when creating a new member.
Property settings: If properties are added to the Member Type you can control frontend access to the property:
- Member can edit: A logged in member can edit this property.
- Show on profile: The property will show on the profile for member that is logged in.
Create. edit and organize properties for this Member Type.
To add a property to the Member Type select Click here to add new property.
Name: The name of the property.
Alias: Used to reference the property in your templates.
Type: Selecting the type will decide the input method for this property. Ie Richtext editor, Date Picker, Image Cropper and so forth. You can edit or create new types in the Developer Section under the Data Type node.
Tab: Place the property on a tab. Additional tabs can be created on the Tabs tab. If the property is placed on the Generic Properties tab it will show on the Properties tab in the content view.
Mandatory: Making the property mandatory means the content cannot be created/saved if the property has no value.
Validation: Add a regular expression to validate the property upon save.
Description: The description will be displayed below the property name when creating/editing the member. A good description is important to the editing experience.
Organize properties with drag and drop. If multiple tabs exists it is possible to drag properties between the different tabs.
A new tab is created by entering a name into the input field and pressing the New tab button.
Name and sort order
Renaming a tab is done simply by changing the name in the input field and saving the Document Type. To change the order of tabs use the drag and drop handle to the left or enter a numeric value in the second input field. Tabs will be displayed from left (lowest value) to right (highest value) in the content section.
Creating Member Groups
Member Groups defines roles for your members that can be used for role based protection. A member can be in multiple groups.
To create a new Member Group click the menu icon next Member Groups node in the Members section. Choose Create, name the group and save the group.
Assigning a Member Group
To assign a member to a specific group find the member you wish to assign and go to the Properties tab. Under the Member Group property there are two columns:
NOT A MEMBER OF GROUP(S): Lists all the groups that the member is not a part of. To assign a group to the member simply click it and it will move to the other column.
MEMBER OF GROUP(S): Lists all the groups that the member is part of. To remove the member from a group simply click it and it will move to the other column.
Umbraco 7.9.0 provides the ability to mark members as sensitive. A sensitive members's data will not be displayed to backoffice users unless they have appropriate permissions.
More information can be found under security.
As a developer you are able to leverage your website easily when you build on the members section of Umbraco.
Although the member section is by default in the Umbraco backoffice. You will have some work to implement it on the front end of your website. The members come from a custom Asp.net membership provider. While the member groups are coming from a custom Role provider. Both are defined in the web.config. You can find out more about the services methods in the reference section of the documentation by following the links below .
- Chapter: Members
- Member API chapter (Coming soon)