Role
Path: Callproof Support - Website - Role
Contents
Role
Lets managers define role labels (for example Manager, Buyer, Decision Maker) used on people/personnel under Accounts when People Tab is on, and for Role filters on Contacts/Accounts search. Roles allow managers to define job titles or relationship labels (such as Manager, Buyer, or Decision Maker) that can be assigned to contact personnel. Assigned roles help organize personnel records and can also be used as search filters on the Contacts and Accounts pages.
Navigation: Home → Settings & Customization → Role
Note:
- The Role menu appears only when the company has People Tab enabled.
- Role pages use the Company Directory sidebar.
- The menu is dynamically generated and is not part of the default `menuurl.sql`.
| User | Access |
|---|---|
| Manager | Full access to view, add, edit, and delete roles |
| Standard User | No access. Redirected to the Dashboard with a "Not a manager" message. |
View Roles
Display all role names configured for the company.
- Log in as a manager.
- Navigate to Home → Settings & Customization → Role.
- The Roles page opens (`/role/`).
- Review the list of available roles.
- Use the available actions to edit or delete roles.
Add Role
Creates a new people-role label for the company so it can be assigned to people on Accounts when People Tab is enabled.
- Open the Roles page.
- Click Add Role.
- The Add Role page opens (`/role/new/`).
- Enter the Role Name.
- Click Save.
- The new role appears in the Roles list.
Edit Role
Updates an existing role’s name so personnel labels stay accurate across Accounts.
- Open the Roles page.
- Click the Edit (pencil) icon beside the desired role.
- The Edit Role page opens (`/role/edit/{id}/`).
- Update the Role Name.
- Click Update.
- The updated role is saved.
Delete Role
Removes a role that is no longer needed so it no longer appears in Role dropdowns or filters. Deleting a role removes only the role definition. Personnel records that previously used the role remain unchanged, and their role reference is cleared.
- Open the Roles page.
- Locate the role to delete.
- Click the Delete (X) icon.
- Confirm the deletion.
- The role is removed from the company.
Notes
- Only managers can manage roles.
- The Role menu is available only when People Tab is enabled.
- Role names are required.
- Role names accept only letters, spaces, and hyphens.
- Maximum role name length is approximately 64 characters.
- Roles are available when adding or editing Contact Personnel.
- Roles can also be used as search filters on the Contacts and Accounts pages.
Technical Information
| Item | Value |
|---|---|
| URL | `/role/` |
| Add | `/role/new/` |
| Edit | `/role/edit/{id}/` |
| Views | `role/views.py` |
| Templates | `templates/role/` |