User Management

Precisely control what other users can edit on your site and whether they can use design features.

Create a new user

To give a team members access to your site, start by creating a user for them.

• Go to Access > Users > Add New.
• Insert a name for your user and click save.
• Set a password for this user.
• Select the roles you want to assign and click save (see roles below).
• Your team member can now log into the backend with the name and password you created.

Roles

By assigning roles to a user, you can control what this user can access on your site. PAGEGRID comes with these predefined user roles:

Permissions

If you want even more control, you can change the individual permissions of a user role.

Go to Access > Roles and select the role you want to edit.

Permissions that start with page- applies to all editable templates.

To enable editing of PAGEGRID items you have to give the role page-edit permission for the pg_container template. The role must also have the pagegrid-process permission enabled to save/edit items.

Templates with an asterisk (*) are configured for edit-related permissions to also inherit to children and through the page tree, unless/until overridden by a page using a different access controlled template.

You can enable view/edit/add/create access through the access tab in the settings for each template individually if you need more control (Templates > yourTemplate > Access).

Global Permissions

The following permissions are relevant for PAGEGRID:

Item Permissions

Item permissions allow you to control what specific roles can do inside a container/group block and all of its child items. They override the global permissions set at the role level and only work on items that allow adding child blocks.

How It Works

1. Enable Permission Management: On a container/group block's Settings tab, check the Manage Access checkbox. This activates per-item permission control for that block and all of its child items.

2. Assign Permissions: Once enabled, you can grant the following permissions to specific roles:

   Permission	Description
   page-add	Allow adding new child items to this block
   pagegrid-drag	Allow dragging items within this block in the editor
   pagegrid-resize	Allow resizing items within this block in the editor
   page-sort	Allow reordering children of this block
   page-move	Allow moving child items to a different parent block

3. Restrict Child Templates: Optionally limit which block templates can be added as children inside this block.

4. Restrict Symbols: Optionally limit which symbols can be added inside this block.

Permission Resolution Order

1. Global — role-level permissions set the baseline for what users can do.
2. Template — template access settings can further restrict which pages a role can interact with.
3. Item — item permissions (Manage Access) override both, granting or denying specific actions for that container and its children. pagegrid-drag and pagegrid-resize apply to children only, not the item itself.

// Check if user can drag an item
$user->hasPermission('pagegrid-drag', $item);

// Check if user can resize an item
$user->hasPermission('pagegrid-resize', $item);

// Check if user can add children to a container
$user->hasPermission('page-add', $container);

// Check if user can sort children of a container
$user->hasPermission('page-sort', $container);

// Check if user can move a child item
$user->hasPermission('page-move', $item);

$container->addable();  // respects item permissions for page-add
$page->sortable();      // respects item permissions for page-sort

More information

Permissions for access control in ProcessWire