> For the complete documentation index, see [llms.txt](https://guide.app.pinpoint.gov.sg/pinpoint-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.app.pinpoint.gov.sg/pinpoint-guide/user-guides/mobile/workspaces.md).

# Workspaces

Want to share media with team members?  Pinpoint's **Workspaces** feature allows users to establish a **shared environment** where multiple users can **upload and view media securely.**&#x20;

## "Personal" and "Shared" workspaces <a href="#personal-and-shared-workspaces" id="personal-and-shared-workspaces"></a>

**Personal workspace:**

* Every user has a private workspace called "My workspace" and media stored here are only accessible by the user.
* This workspace and its contents cannot be shared with other users.

**Shared workspaces:**

* Shared workspaces can be created by users for collaboration with other users based on assigned [roles](/pinpoint-guide/user-guides/desktop-laptop/workspaces.md#roles-in-workspaces).
* Each shared workspace also includes ["Workspace logs"](#workspace-logs), which logs user activity in the workspace.

  > Users should ensure that materials uploaded to shared workspaces are in line with the expectations of their supervisors.
  >
  > **Note that "Workspace Logs" is currently&#x20;**<mark style="color:red;">**not available**</mark>**&#x20;on mobile.**

<div><figure><img src="/files/nGlRe2SSwLVy8VNqJ06G" alt="" width="333"><figcaption></figcaption></figure> <figure><img src="/files/Njsam1B0ZDwZQAebWunO" alt="" width="332"><figcaption></figcaption></figure></div>

## Roles in workspaces (Mobile Version)

Pinpoint allows administrators to set specific levels of permissions, based on these defined roles:

**Administrator**:&#x20;

* Has full control over the workspace, including the ability to manage other users and make changes to workspace settings.
* **Administrators** can also modify the roles of other administrators including themselves in the workspace. Once forfeited, all administrator privileges for that workspace will be revoked unless reassigned.
* There must always be at least one **administrator** assigned to a workspace at all times. Consequently, if a user is the sole **administrator**, they cannot remove themselves from the workspace without appointing another user as an **administrator**.
* By default, workspace owners are set as **Administrators**

**Contributor**:&#x20;

* Can upload and edit media within the workspace.

**Viewer**:&#x20;

* Has view-only access to the workspace and cannot make any changes

Refer to the table below for an overview of the roles:

<table><thead><tr><th width="235">Functions</th><th align="center">Administrator</th><th align="center">Contributor</th><th align="center">Viewer</th></tr></thead><tbody><tr><td>Manage access                                 </td><td align="center">✅</td><td align="center"><strong>View-only</strong></td><td align="center"><strong>View-only</strong></td></tr><tr><td>Rename workspace                                         </td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Delete workspace      </td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Delete media</td><td align="center">✅</td><td align="center">❌</td><td align="center">❌</td></tr><tr><td>Upload media</td><td align="center">✅</td><td align="center">✅</td><td align="center">❌</td></tr><tr><td>Edit metadata</td><td align="center">✅</td><td align="center">✅</td><td align="center"><strong>View-only</strong></td></tr><tr><td>Filter functions</td><td align="center">✅</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Download media</td><td align="center">✅</td><td align="center">✅</td><td align="center">✅</td></tr><tr><td>Create links</td><td align="center">✅</td><td align="center">✅</td><td align="center">✅</td></tr></tbody></table>

Your role in the workspace is displayed above the workspace name.

## How to create a workspace

1. Click the workspace dropdown, then select "Create new workspace".

   <div><figure><img src="/files/NHHIPxO3zEBma8WhfVLE" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/2UkEPVXztx74EOs5tSby" alt="" width="333"><figcaption></figcaption></figure></div>
2. Type in the desired workspace name.
3. Click the "Save" button.

   <figure><img src="/files/AzMmcLOGUJnLejyvOSZK" alt="" width="332"><figcaption></figcaption></figure>
4. Select "Upload media" to start [uploading](/pinpoint-guide/user-guides/mobile/uploading.md) media to your new workspace.

## Renaming workspace

1. Click the settings icon on the top-right and select "Rename workspace".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/ohtcGjpUFboSvGKr3laI" alt="" width="332"><figcaption></figcaption></figure></div>
2. Enter a new workspace name and Click "Save".
3. The new workspace name will be reflected for all users upon refresh.

## Leaving workspace

Note that leaving a workspace is not possible if you are the only administrator.

1. Click the settings icon on the top-right and select "Leave workspace".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/5JiYWyFqpWTaTwTNr2o1" alt="" width="332"><figcaption></figcaption></figure></div>
2. You will now have left the workspace. Others still in the workspace will continue to have access to its media.

## Deleting workspace

1. Click the settings icon on the top-right and select "Delete workspace".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/5JiYWyFqpWTaTwTNr2o1" alt="" width="332"><figcaption></figcaption></figure></div>
2. Type "DELETE" and click "Delete" in the pop-up.

   <figure><img src="/files/usNfqRP7pLwIRKVDFaSA" alt="" width="333"><figcaption><p>Check that you are in the correct workspace before deleting</p></figcaption></figure>
3. The workspace, including all media stored in it, will be **permanently deleted**. Additionally, all users within the workspace will no longer have access to the workspace.

## **View members**

Viewers and Collaborators can view the users that are in the workspace.

1. Click the settings icon on the top-right and select "View workspace members".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/cDcqD2jxK4Sgbiq9ObOh" alt="" width="333"><figcaption></figcaption></figure></div>
2. You will see all other users in the workspace as well as their roles.

## Managing Access&#x20;

Administrators can add and remove users from their workspaces to manage their access.

### **Adding Users:**

1. Click the settings icon on the top-right and select "Manage workspace access".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/zUGKTPUJlNMmbr1AjubH" alt="" width="335"><figcaption></figcaption></figure></div>
2. Enter a valid user email address (with the domain **.gov.sg**). You can add up to 500 users at once by typing in their email addresses, separated by commas or semicolons (like this: <email1@example.com>, <email2@example.com>).
3. Select a role from the dropdown list.
   * To see the permission given to each role, click the tooltip or click [here](#managing-access).

     <figure><img src="/files/PJjtVFgMtti1GAJv5qci" alt="" width="332"><figcaption></figcaption></figure>
4. Click "Add user".
   * If the user is new to Pinpoint, they will show up under "Pending users". The invitation to the workspace will be sent to them through their emails. They will be added to the workspace automatically after they login for the first time.
   * If the user is already a Pinpoint user, they will show up under "Users with access". A notification will be sent to them through their emails notifying them that they have been added to your workspace.

### **Removing User access / Revoking User invites:**

1. Click the settings icon on the top-right and select "Manage workspace access".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/zUGKTPUJlNMmbr1AjubH" alt="" width="335"><figcaption></figcaption></figure></div>
2. Click the user's role and then "Remove user" or "Revoke invite" to remove their access.

   <div><figure><img src="/files/2dOoS9cYeHFefWIcgvBf" alt="" width="333"><figcaption></figcaption></figure> <figure><img src="/files/txtFt6UfzNqltr8osuIo" alt="" width="332"><figcaption></figcaption></figure></div>

### **Modifying User Roles:**&#x20;

1. Click the settings icon on the top-right and select "Manage workspace access".

   <div><figure><img src="/files/CYtKW7MGF90zuftfkcvJ" alt="" width="331"><figcaption></figcaption></figure> <figure><img src="/files/zUGKTPUJlNMmbr1AjubH" alt="" width="335"><figcaption></figcaption></figure></div>
2. Click the user's role and then select a new one.&#x20;

   <div><figure><img src="/files/2dOoS9cYeHFefWIcgvBf" alt="" width="333"><figcaption></figcaption></figure> <figure><img src="/files/HrN96sWFFFbOAFJTROJo" alt="" width="332"><figcaption></figcaption></figure></div>
