# Organizations

## Overview

Thunkable's organizations are a set of administration and collaboration capabilities that allow multiple team members to work on a single project. Creators can jointly design and develop a single, shared project asynchronously.&#x20;

A single Creator can edit the project at a time, and their changes are available for other members to view when they refresh their page.&#x20;

## Organization Management

{% hint style="info" %}
This feature may only be available for Creators on certain Thunkable plans. Please refer to our pricing page for more information: [Thunkable pricing](https://thunkable.com/pricing).
{% endhint %}

Thunkable Creators have:&#x20;

* roles with the organization (Admin or Member)
* permissions within a project (Project Owner, Editor, or Viewer)
* modes when actively within a project (Editing or Viewing)

### Roles and Permissions Summary

<table><thead><tr><th width="237">Action</th><th width="119">Org. Admin</th><th width="149">Project Owner</th><th>Editor</th><th>Viewer</th></tr></thead><tbody><tr><td>Add/Remove members</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td><td>No</td></tr><tr><td>Publish</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td><mark style="color:green;">Yes</mark></td><td>No</td></tr><tr><td>Share</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr><tr><td>Download</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td><mark style="color:green;">Yes</mark></td><td>No</td></tr><tr><td>Access project settings</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td><mark style="color:green;">Yes</mark></td><td>No</td></tr><tr><td>Grant Edit Access</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr><tr><td>Remix project</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td><mark style="color:green;">Yes</mark></td><td>No</td></tr><tr><td>Duplicate project</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr><tr><td>Delete project</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr><tr><td>Figma import</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr><tr><td>Versioning</td><td>-</td><td><mark style="color:green;">Yes</mark></td><td>No</td><td>No</td></tr></tbody></table>

### Admin Dashboard

The Organizations Admin Dashboard is available for an organization’s Admins. This is where they can add, remove, and modify members' roles.

#### Access Admin Dashboard

1. Click your **profile image** in the upper right.
2. Select **Organizations**. <br>

   <div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2Ff3BHkXwNqibWDUtqXYlL%2FOrganizations%20Dashboard.png?alt=media&#x26;token=675d0954-bce5-4505-971c-2c109db6d562" alt="" width="144"><figcaption></figcaption></figure></div>
3. The Organizations page lists the organizations for which you hold admin status.

#### View Organization

1. Click an organization name.
2. The Members tab lists the organization’s members.&#x20;
3. The Projects tab lists the organization’s projects.

#### Add Member

1. Click **Add Member**.
2. Input the invitee’s email address.
3. Indicate their role (Admin or Member).&#x20;
4. Click **Add**.

#### Modify a Role

1. Navigate to the **Members tab** of the organization’s page.&#x20;
2. Click the **role dropdown** associated with the member.
3. Select the appropriate role (Admin or Member).

#### Remove a Member

1. Navigate to the **Members tab** of the organization’s page.
2. Click the **role dropdown** associated with the member.
3. Select **Remove**.
4. Confirm the removal.

## Assigning a Project to an Organization

### Creating a New Project in an Organization

When creating a new project, organization members can assign it to their own personal projects or the organization.&#x20;

Projects assigned to the organization can be collaborated on by members of the organization.&#x20;

Once a project is assigned to an organization, it cannot be converted into a personal project. It remains part of the organization and cannot be moved to any one Creator’s personal projects, including the admin of the organization.

Projects created within an organization cannot be shared with users outside of the organization.

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FkuqdrKDijWLie6BLzzpP%2FOrganizations%20-%20invite%20to%20project.png?alt=media&#x26;token=bbe3b7a5-8652-4b8b-a144-3885f829c2fc" alt=""><figcaption></figcaption></figure>

### Duplicate into an Organization

The owner of a personal project can make a copy of the project in an organization in which they are a member. To do this, as the project's owner:

1. On the project's Design tab, click the **Project Actions** icon.
2. Select **Duplicate into...**<br>

   <div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FysU6R0gGKwl105bJC2sl%2FProject%20Actions%20%3E%20Duplicate%20into.png?alt=media&#x26;token=22360b8a-174e-46a6-a3d6-ef4b63440543" alt="" width="250"><figcaption></figcaption></figure></div>
3. In the modal provided, give the project a name.
4. Use the dropdown menu to indicate which organization you want to copy the project into.
5. Click **Duplicate into Organization**.<br>

   <div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FSg4EqtpKQ3gDen46w03m%2FDuplicate%20into%20an%20Organization.png?alt=media&#x26;token=c3662962-3130-4167-8c10-ab563be5677f" alt="" width="375"><figcaption></figcaption></figure></div>
6. You are the owner of the newly created project in the selected organization. There are no other members with permissions on this project yet.

## Viewing and Editing Modes

When accessing organization projects, members are in one of two modes: editing or viewing. There can only be one project member in editing mode at any given time – all other organization members remain in viewing mode.&#x20;

Members accessing the project in viewing mode cannot make active changes to the shared project.

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FHaxa5yikQnsgrxt8P79i%2FScreenshot%202023-01-04%20at%202.39.07%20PM.png?alt=media&#x26;token=1cef3c72-4b77-4506-b1e9-d2132556bea5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

### Transferring Editing Access

Only one project member can be in editing mode at a time.&#x20;

* To request editing access, a member in viewing mode must click the chevron next to **VIEWING**.
* Click **Request Edit**.
* The member currently in editing mode is notified that another member has requested editing access.
* When the member currently in editing mode switches to viewing mode, the member requesting editing access is switched to editing mode and can make changes to the project.
  {% endhint %}

<div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FUYFoNodnsvczuNkOJIk0%2Funnamed.png?alt=media&#x26;token=c41b8bd6-1339-4056-a7d4-c823f6429b1e" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
If the member currently in editing mode is offline, no other member can edit the project. The member currently in editing mode must return online and grant access to a different member.
{% endhint %}

## Sharing and Updating Permissions

To share a project with a user in your organization:

1. Click the **Share** icon.\
   ![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FQS5y6yvVC63WNLnjllGK%2FShare%20icon.png?alt=media\&token=f7765d5c-f7a3-4865-9fd7-f560b412857e)
2. Select **Project Sharing**.&#x20;
3. Enter the **email address** of the user you want to add to the project
4. Assign the user a **permission level**: Editor or Viewer.&#x20;
5. Click **Add**.

To update the permissions of a user in your organization:

1. Click the **Share** icon.\
   ![](https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FQS5y6yvVC63WNLnjllGK%2FShare%20icon.png?alt=media\&token=f7765d5c-f7a3-4865-9fd7-f560b412857e)
2. Click the user's existing permission level (EDITOR or VIEWER) and select Editor, Viewer, or Remove.&#x20;

## Collaborating with Comments

Organization members can collaborate on projects by adding comments to UI components.

### Add Comments

To add a comment to a UI component:

1. Access the project’s Design tab.
2. Ensure you’re in **Editing** mode.&#x20;
3. Click the **Comment** icon to open the comment panel on the right.
4. Click to select a UI component on a screen or in the component tree.&#x20;
5. Type your comment in the provided text input field in the comment panel.
6. Click the **send** button.
7. To add comments to other UI components, repeat steps 4-6.&#x20;
8. Click the **Comment** icon to close the comment panel.

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FVP2QisXAxdsbZU9cwYQu%2FOrganizations%20%3E%20Commenting.png?alt=media&#x26;token=4c52008e-b4e5-49ea-b192-af1833ed60e4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Each UI component is limited to 25 comments, and each comment has a maximum character count of 2000.
{% endhint %}

### View Comments

To view comments on a UI component:

1. Access the project’s Design tab.
2. Click the **Comment** icon to open the comment panel on the right.
3. Comments are grouped with the UI component they were added to.
   1. Comments are displayed in the order they were added, with the most recent comment appearing at the bottom of the UI component's comments.
   2. UI components with the most recent comments appear at the top of the comment panel, making it easier to find the most recent discussions.
4. Click the Comment icon to close the comment panel.

### Delete Comments

You can delete your own comments. To delete a comment:

1. Access the project’s Design tab.
2. Ensure you’re in **Editing** mode.&#x20;
3. Click the **Comment** icon to open the comment panel on the right.
4. Locate the comment you want to delete.
5. Click the vertical ellipsis icon within the comment’s box.
6. Click **Delete**.
7. This cannot be undone. Click **Delete** to confirm the deletion of the comment.
8. Click the **Comment** icon to close the comment panel.

***

{% hint style="success" %}
**Have feedback on this doc?** Please take a moment to share your feedback here: [Thunkable Docs Feedback](https://docs.google.com/forms/d/e/1FAIpQLSfCwn5L2xyla-LSLZX0DSWFcFeJ43qp-r1tELCacuVS2zduLA/viewform?usp=sf_link). Your valuable insights will help us improve and better serve you in the future.
{% endhint %}
