Last updated October 30, 2015. Created on March 31, 2001.
Edited by ashish_nirmohi, kenisha.lehari, musicnode, gochati. Log in to edit this page.

The user module allows users to register, log in, and log out. Users benefit from being able to sign on because this associates content they create with their account and allows various permissions to be set for their roles.

The user module supports user roles, which can be set up with fine-grained permissions allowing each role to do only what the administrator permits. Each user is assigned one or more roles. By default there are three roles: anonymous (a user who has not logged in) and authenticated (a user who has signed up and been authorized), and in Drupal 7 only, administrator (a signed in user who will be assigned site administrator permissions).

Users can use their own name or handle and can fine tune some personal configuration settings through their individual my account page. Registered users need to authenticate by supplying their username and password, or alternately an OpenID login. (In Drupal 5, users are able to log in with either a local username and password, or a remote username and password, such as a DelphiForums ID or an ID from another Drupal-powered website, more info here.)

A visitor accessing your website is assigned a unique ID, the so-called session ID, which is stored in a cookie. For security's sake, the cookie does not contain personal information but acts as a key to retrieving the information stored on your server.

You can:

  1. view your user page at when you're logged in
  2. administer users at People (Administer > People) in Drupal 7, and (Administer > User) in previous versions.
  3. create new users on the People page through the add user link in Drupal 7, and (Administer > User > Add user) in previous versions.
  4. configure user registration, user email, and user picture settings on the Account settings page (Administer > Configuration > People > Account settings) in Drupal 7, and (Administer > Settings > User) in previous versions.
  5. allow users to select themes in versions prior to Drupal 7 from their user account by enabling themes in (Administer > Themes).
  6. read user profile help at (Administer > Help > User).
  7. configure access permissions at (Administer > People > Permissions) in Drupal 7, and (Administer > Access control) in previous versions.

Technical details for Drupal 7

Core module: Yes.
Dependencies: None.
Related Modules: None.
Permissions: Administer people. Also see the API docs at user
API Documentation:, user.api.php, user.install, user.module, user_form_test.module,,
Template files: user-picture.tpl.php, user-profile.tpl.php, user-profile-category.tpl.php, user-profile-item.tpl
Other files:, user.css, user-rtl.css, user.js, user.permissions.js
Database tables (5): authmap, role_permission, role, users, users_roles. Also see the API docs at user schema

Looking for support? Visit the forums, or join #drupal-support in IRC.