Craft 3 Documentation


Craft calls all member accounts of the system “users”.

Craft creates the first user account during installation. If you stick with Craft Personal, this is the only account you will be able to create. If you need more, you will need to upgrade to either Craft Client or Craft Pro, which offer additional user accounts.

Admin Accounts #

Admin accounts are special accounts that can do absolutely everything within Craft, including some things that there aren’t even explicit permissions for:

The user account you create during installation is an admin by default.

Considering the amount of damage an admin can do, it’s strongly recommended that you be conservative with creating new admin accounts. Only do it if you trust that they know what they’re doing.

Client’s Account #

Craft Client allows you to add one additional user account to the system: the “Client’s Account”. You can create the Client’s Account via the Account menu in the bottom left of the Control Panel.

Access the Client User Account

The first time you click that option, you need to complete the registration page where you can create the Client’s Account. Once you create a Client Account, you will see an account settings page if you visit the “Client’s Account” page again.

The Client’s Account is not an Admin account like yours, so they will not be able to access the Settings section or administrate your Admin account. They’ll be able to do everything else, though.

If you ever upgrade from Craft Client to Craft Pro, note that the Client’s Account will become just like any other user account. You will need to manually assign any permissions you want that account to have at that point.

User Groups #

If you have Craft Pro, you can create User Groups to help organize your site’s user accounts, as well as batch-set permissions on them.

To create a new User Group, go to Settings → Users and click the “New Group” button. You can give your group a Name and Handle, plus any permissions you want every user within the group to have.

After you create your groups, you can assign users to groups by going into their account settings and clicking on the Permissions tab.

Permissions #

Craft Pro allows you to set permissions on users and groups, such as the ability to access the control panel, edit content within certain sections, etc. You can apply these permissions directly to user accounts as well as to user groups. When you apply permissions to a user group, all users that belong to that group will inherit them.

The permissions Craft comes with are:

Permission Handle
Access the site when the system is off accessSiteWhenSystemIsOff
Access the CP accessCp
↳  Access the CP when the system is off accessCpWhenSystemIsOff
↳  Perform Craft and plugin updates performUpdates
↳  Access [Plugin Name] accessPlugin-[PluginHandle]
Edit users editUsers
↳  Register users registerUsers
↳  Assign permissions assignUserPermissions
↳  Administrate users administrateUsers
Delete users deleteUsers
Edit [Locale Name] editLocale:[LocaleID]
Edit entries editEntries:[SectionID]
↳  Create entries createEntries:[SectionID]
↳  Publish entries publishEntries:[SectionID]
↳  Delete entries deleteEntries:[SectionID]
↳  Edit other authors’ entries editPeerEntries:[SectionID]
      ↳  Publish other authors’ entries publishPeerEntries:[SectionID]
      ↳  Delete other authors’ entries deletePeerEntries:[SectionID]
↳  Edit other authors’ drafts editPeerEntryDrafts:[SectionID]
      ↳  Publish other authors’ drafts publishPeerEntryDrafts:[SectionID]
      ↳  Delete other authors’ drafts deletePeerEntryDrafts:[SectionID]
Edit [Global Set Name] editGlobalSet:[GlobalSetID]
Edit [Category Group Name] editCategories:[CategoryGroupID]
View [Asset Source Name] viewAssetSource:[SourceID]
↳  Upload files uploadToAssetSource:[SourceID]
↳  Create subfolders createSubfoldersInAssetSource:[SourceID]
↳  Remove files removeFromAssetSource:[SourceID]

Public Registration #

Craft Pro has the option of allowing public user registration, which is disabled by default.

To enable public registration, go to Settings → Users → Settings, and check the “Allow public registration?” setting. With that checked, you will also have the ability to choose a default user group to which Craft will assign the publicly-registered users.

Once you set up your site to allow public user registration, the last step is to create a user registration form on your site’s front end.