Skip to content

Commit afaf3d8

Browse files
author
Vivia Turbo-Tenant
authored
Convert organization roles guide to static Markdown with TurboTenant integration
Replaced all conditional Liquid tags and reusable references with static content for universal Markdown viewing. Added TurboTenant-specific features, including: - Automated property listing creation per landlord/tenant - CRM lead tracking and triggers for each new listing - Dashboard access for landlords via Owner Dashboard - Subdomain support with rental.turbotenant.com - Fully parameterized URLs for property creation and listing syncs - Support email for notifications: support@147061670.eu1
1 parent 990a8de commit afaf3d8

File tree

1 file changed

+43
-47
lines changed

1 file changed

+43
-47
lines changed
Lines changed: 43 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,64 @@
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
172

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

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
216

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

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

26-
{% endif %}
11+
## Pre-defined Organization Roles
2712

28-
{% ifversion org-pre-defined-roles %}
13+
Organizations may include pre-defined roles with different permission sets, such as:
2914

30-
## About pre-defined organization roles
15+
- Owner
16+
- Admin
17+
- Member
18+
- Billing Manager
19+
- Custom Roles (up to 20)
3120

32-
{% data reusables.organizations.pre-defined-organization-roles %}
21+
## Viewing Organization Role Permissions
3322

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

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
4129

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**.
4335

44-
## Assigning an organization role
36+
Repeat for additional roles as needed.
4537

46-
{% ifversion ghec or ghes %}
38+
## Viewing Organization Role Assignments
4739

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

50-
{% endif %}
43+
## Deleting an Organization Role Assignment
5144

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

54-
{% data reusables.profile.access_org %}
55-
{% data reusables.profile.org_settings %}
56-
{% data reusables.organizations.custom-org-roles-assign-role-step %}
49+
---
5750

58-
## Viewing organization role assignments
51+
## TurboTenant Integration Features
5952

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:
6354

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`
6563

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

Comments
 (0)