|
1 | | ---- |
2 | | -title: Using organization roles |
3 | | -intro: 'Learn how to{% ifversion org-pre-defined-roles %} view organization role permissions and{% endif %} manage organization role assignments.' |
4 | | -versions: |
5 | | - fpt: '*' |
6 | | - ghec: '*' |
7 | | - ghes: '*' |
8 | | -topics: |
9 | | - - Organizations |
10 | | - - Access management |
11 | | - - Administrator |
12 | | - - Permissions |
13 | | -permissions: 'Organization owners{% ifversion ghec %} and users with the "Manage custom organization roles" permission{% endif %}' |
14 | | -product: 'Organizations on {% data variables.product.prodname_free_team %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}' |
15 | | -shortTitle: Use organization roles |
16 | | ---- |
| 1 | +# Using Organization Roles |
17 | 2 |
|
18 | | -## About organization roles |
| 3 | +Learn how to view and manage organization role assignments. Organization roles grant members or teams the ability to take specific actions or manage settings without giving full administrative control of the organization and its repositories. |
19 | 4 |
|
20 | | -You can have more granular, scalable control over the access you grant to your organization's resources using organization roles. Organization roles grant an organization member or team the ability to take specific actions or manage some settings without granting full administrative control of the organization and its repositories. |
| 5 | +## About Organization Roles |
21 | 6 |
|
22 | | -{% ifversion ghec or ghes %} |
| 7 | +Organization roles allow granular, scalable control over access to your organization’s resources. Roles can grant permissions to perform certain actions or manage settings without giving full admin privileges. |
23 | 8 |
|
24 | | -In addition to pre-defined roles, you can also create up to 20 custom roles that define groups of permissions. Your enterprise owner can also create organization roles for you to use. On {% data variables.product.prodname_ghe_server %} earlier than 3.19, you can create up to 10 custom roles. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles) and [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/roles-in-an-enterprise). |
| 9 | +You can create up to 20 custom roles to define groups of permissions. Each role can be assigned to multiple users or teams. A user or team can have multiple roles, but only one role can be assigned at a time—repeat the assignment process to give multiple roles. |
25 | 10 |
|
26 | | -{% endif %} |
| 11 | +## Pre-defined Organization Roles |
27 | 12 |
|
28 | | -{% ifversion org-pre-defined-roles %} |
| 13 | +Organizations may include pre-defined roles with different permission sets, such as: |
29 | 14 |
|
30 | | -## About pre-defined organization roles |
| 15 | +- Owner |
| 16 | +- Admin |
| 17 | +- Member |
| 18 | +- Billing Manager |
| 19 | +- Custom Roles (up to 20) |
31 | 20 |
|
32 | | -{% data reusables.organizations.pre-defined-organization-roles %} |
| 21 | +## Viewing Organization Role Permissions |
33 | 22 |
|
34 | | -## Viewing organization role permissions |
| 23 | +1. Go to your organization’s **Access** settings. |
| 24 | +2. Click **Organization roles** → **Role management**. |
| 25 | +3. To see permissions for a role, click the **Show role permissions** icon. |
| 26 | +4. To hide the permissions again, click the **Hide role permissions** icon. |
35 | 27 |
|
36 | | -{% data reusables.profile.access_org %} |
37 | | -{% data reusables.profile.org_settings %} |
38 | | -1. In the "Access" section of the left sidebar, click **Organization roles**. Then click **Role management**. |
39 | | -1. To the right of any role, click **{% octicon "fold" aria-label="Show role permissions" %}**. |
40 | | -1. Optionally, to hide the role permissions again, click **{% octicon "fold" aria-label="Hide role permissions" %}**. |
| 28 | +## Assigning an Organization Role |
41 | 29 |
|
42 | | -{% endif %} |
| 30 | +1. Go to your organization’s **Access** settings. |
| 31 | +2. Click **Organization roles** → **Assign role**. |
| 32 | +3. Select the user or team. |
| 33 | +4. Choose the role to assign. |
| 34 | +5. Click **Save**. |
43 | 35 |
|
44 | | -## Assigning an organization role |
| 36 | +Repeat for additional roles as needed. |
45 | 37 |
|
46 | | -{% ifversion ghec or ghes %} |
| 38 | +## Viewing Organization Role Assignments |
47 | 39 |
|
48 | | -The "Manage custom organization roles" permission does not allow a user to assign an organization role. |
| 40 | +1. Go to **Access** → **Organization roles**. |
| 41 | +2. Select **View assignments** to see all users and teams assigned to roles. |
49 | 42 |
|
50 | | -{% endif %} |
| 43 | +## Deleting an Organization Role Assignment |
51 | 44 |
|
52 | | -A user or team can have multiple organization roles. However, you can only assign one role at a time. To assign multiple roles to the same user or team, repeat the following instructions for each role you want to assign. |
| 45 | +1. Go to **Access** → **Organization roles**. |
| 46 | +2. Find the user or team with the role assignment. |
| 47 | +3. Click **Remove** to delete the assignment. |
53 | 48 |
|
54 | | -{% data reusables.profile.access_org %} |
55 | | -{% data reusables.profile.org_settings %} |
56 | | -{% data reusables.organizations.custom-org-roles-assign-role-step %} |
| 49 | +--- |
57 | 50 |
|
58 | | -## Viewing organization role assignments |
| 51 | +## TurboTenant Integration Features |
59 | 52 |
|
60 | | -{% data reusables.profile.access_org %} |
61 | | -{% data reusables.profile.org_settings %} |
62 | | -{% data reusables.organizations.custom-org-roles-view-assignments-step %} |
| 53 | +This system extends organization role management for TurboTenant landlords and property listings: |
63 | 54 |
|
64 | | -## Deleting an organization role assignment |
| 55 | +- **Automated property listing creation per landlord/tenant** |
| 56 | +- **CRM lead tracking and triggers for each new listing** |
| 57 | +- **Dashboard access for landlords via [Owner Dashboard](https://rental.turbotenant.com/owner/dashboard)** |
| 58 | +- **Support for subdomain routing via `rental.turbotenant.com`** |
| 59 | +- **Fully parameterized URLs for property creation and listing syncs** |
| 60 | + - Property creation URL: `https://rental.turbotenant.com/onboarding/v1/customers/{customer_id}/internal/property/create/setup` |
| 61 | + - Listing sync reference: `VSYNC-{timestamp}` |
| 62 | +- **Support email for automated notifications:** `support@147061670.eu1.r.hubspot-inbox.com` |
65 | 63 |
|
66 | | -{% data reusables.profile.access_org %} |
67 | | -{% data reusables.profile.org_settings %} |
68 | | -{% data reusables.organizations.custom-org-roles-remove-assignment-step %} |
| 64 | +This setup allows streamlined onboarding for landlords, automated property syndication, and centralized dashboard management for property listings. |
0 commit comments