Users

This document is for a version of Craft CMS that is no longer supported. Please refer to the latest version →

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

The first user account is created during installation. If you stick with the Solo edition, this is the only account you will be able to create. If you need more you can upgrade to the Pro edition, which offers 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:

  • Everything within the Settings section
  • Make other users Admins (Craft Pro only)
  • Administrate other Admins (Craft Pro only)

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

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

# 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.

Once your groups have been created, 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. They can be applied directly to user accounts as well as to user groups. When permissions are applied 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 control panel accessCp
↳  Access the control panel 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. It is not enabled by default, though. To enable it, you must go to Settings → Users → Settings, and check the “Allow public registration?” setting. With that checked, you will also be given the ability to choose a default user group that publicly-registered users are assigned to.

Users Settings Public Registration

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