# Workspaces and projects

{% embed url="<https://www.youtube.com/watch?v=qVcy9hnRImk&list=PLulpFBGeM9D56pqKcZYKOb_r10ax0Vzhy&index=7>" %}

{% hint style="info" %}
This doc is for Workspace Admin
{% endhint %}

## Definitions and concepts

<table><thead><tr><th width="160">Concept</th><th>Definition</th></tr></thead><tbody><tr><td>Workspace</td><td>The main place where all of your maps and data live.</td></tr><tr><td>Project</td><td>A subset of maps within the workspace. Can be public (open to all members in the workspace) or private (invite only)</td></tr><tr><td>Recent</td><td><p>Lists all the maps in you have recently viewed or edited.</p><p>Can be filtered down to show: maps you own ("My Recent Maps"), maps that belong to the current workspace ("Recent in Workspace"), or all recently viewed maps ("All recent maps").</p></td></tr><tr><td>Drafts</td><td>Lists the maps you created in this Workspace that do not belong to any Project in the Workspace. Unique and personal to each member with a full seat.</td></tr><tr><td>Map</td><td>A map in Felt</td></tr><tr><td>Member</td><td>Anyone invited to your account. Members have one of two licenses: <strong>Full seat</strong> or <strong>Viewer</strong>. See <a href="/pages/I7atLGkuLhdBRwJZe5ui">licenses.md</a>.</td></tr><tr><td>Full seat</td><td>A paid license required to create maps, upload data, edit layers, contribute changes, or post comments. Counts toward your seat allotment.</td></tr><tr><td>Viewer</td><td>An unlimited free license. Can view maps shared with them and read comments. Cannot post comments or edit.</td></tr><tr><td>Permission</td><td>What a member can do on a specific project, map, or data source. Permissions include View, Contribute, Edit, and Admin. See <a href="/pages/4UxW7FiY1Cp1HfQtafHI">felt-permissions.md</a>.</td></tr><tr><td>Admin</td><td>A full-seat member with full access to manage workspace settings, members, billing, and the workspace's projects.</td></tr><tr><td>Project Admin</td><td>A full-seat member who has created or been granted admin on a project, with permissions to manage that project. Scoped to specific projects.</td></tr></tbody></table>

## Workspaces

[Workspaces](/getting-started/your-workspace.md) serve as the primary place where organizations collaborate and share maps and data. Each Workspace hosts its own maps and data sources. The Workspace is also the billing entity in Felt.

You can create a new Workspace and/or switch between different Workspaces you belong to by clicking on the name of the workspace in the [Felt homepage](https://felt.com/maps)

<figure><img src="/files/8I0fR7BLQQCQlp85tLt7" alt="" width="181"><figcaption></figcaption></figure>

Workspace Admin can manage members, usage, billing, API tokens, and workspace-level settings in the Settings section of the workspace

<figure><img src="/files/L8GZZO7Mc2zNPx4PD6WY" alt=""><figcaption></figcaption></figure>

## Workspace settings

Settings for the Workspace live here: <https://felt.com/maps/latest/settings>. In this section of Felt you can control settings at the Workspace level.

Every Workspace has access to the following settings:

* **Basics:** Workspace Name and Icon
* **Remove:** Leave or Delete the workspace

Enterprise Workspaces have access to additional settings:

{% hint style="success" %}
The features below are only available to customers on the [Enterprise plan](https://felt.com/pricing). To upgrade, [contact sales](https://felt.com/sales).
{% endhint %}

* **Map Sharing**: Default public sharing settings

<figure><img src="/files/vm7lSSB5c9SUbe70C538" alt="" width="375"><figcaption></figcaption></figure>

* **Hosting Region**: Select a region to host your data in Felt
  * See [Regional hosting](/administration/regional-hosting.md) for more information

<figure><img src="/files/5vqXAPrAc4AtwDZaHpRp" alt="" width="375"><figcaption></figcaption></figure>

* **Joining the Workspace:** Allow users with your company email domain to join the account automatically upon sign up, and control the default permissions

<figure><img src="/files/L49tRit0taWmix7ReafB" alt="" width="375"><figcaption></figcaption></figure>

* **Enterprise SSO**: Enable SSO login for your company's account
  * See [Single sign-on (SSO)](/administration/single-sign-on-sso.md) for more information

## Navigating the workspace

The navigation for a Workspace is on the left-hand side when viewing [Felt App's Homepage](https://felt.com/).

<figure><img src="/files/5IlF4JkQ3z21LSUB27Xc" alt=""><figcaption></figcaption></figure>

### Recents

Maps in **Recents** show you all maps you’ve viewed and edited. They can be filtered down the following ways:

* My Recent Maps: shows you all the recently opened maps that you created
* Recent in Workspace: shows you all the maps you view and edit in the current workspace
* All recent maps: shows you all the maps you view and edit, including public maps you view

### Drafts

**Drafts** hosts the maps editors create in the Workspace that do not belong to any Project yet, and the **Drafts** space is unique to each editor. **Drafts** is a staging area for working on new maps you create and own. You can move maps within the Workspace to a Project you have access to (see below).

Editors can invite collaborators to view a map in their Drafts, but the collaborator will not be able to see any other maps in the Editors Drafts space.

### Moving Maps

You can move maps between Drafts and Projects in the Workspace. You can also transfer a map from one Workspace to another, which duplicates the map in the target Workspace.

You can move a map when viewing a map in the Workspace

<figure><img src="/files/NttamgpCiVgJm1WbNHU7" alt=""><figcaption></figcaption></figure>

or when viewing a map directly

<figure><img src="/files/FXklKm3R0wI7pDkekwU3" alt=""><figcaption></figcaption></figure>

#### Moving maps between workspaces

You can copy maps between workspaces in Felt. Doing this creates a duplicate copy of the original map into the other workspace. Everything on the map gets copied over to the new workspace except for comments. Also, the URL will be different in the copied map the original map. Note: if the original map is embedded in a website, be sure to update the embed link.

To get the map into the other account, first make sure you are an editor in both your workspace and the other workspace. Then do the following:

1. Open the map
2. Click Felt menu (top left) > File > Move map...

   <figure><img src="/files/Rc8fYW4meSCzoBdJUKao" alt="" width="310"><figcaption></figcaption></figure>
3. In the modal select the target workspace (bottom left)

   <figure><img src="/files/bmvMAmmUh2dP5Y3Icoz8" alt="" width="211"><figcaption></figcaption></figure>
4. Select a target project in the new workspace
5. Click "Duplicate"

### Changing the Display

Felt provides different layout and order options for viewing all maps in any given Project. To see these options, click on the View dropdown on the top-right of any Project page

<figure><img src="/files/zb5atMIMKWFtrklMTekp" alt="" width="375"><figcaption></figcaption></figure>

## Projects

Workspaces are organized into Projects, which allow you to organize your maps into different spaces within the Workspace.

By default all new Workspaces start with a **`General`** Project. To add a new project, click **`+ Create Project`** on the [Felt home](https://felt.com/) view of the workspace

<figure><img src="/files/7AiYEAdgGbdCy6u6p6xV" alt="" width="277"><figcaption></figcaption></figure>

To rename any project, double-click on the name in the Project view.

<figure><img src="/files/ZzszBDSRMtDQZVJ1dS2Z" alt="" width="375"><figcaption></figcaption></figure>

### Sharing maps with Projects

To share maps between teammates, move maps into Projects in the workspace. Projects control which teammates have access to which maps.

Projects can either be Public (open to the entire Workspace) or Private (invite only), which allow for finer access control within your organization. Members in the same workspace can access maps in public projects and maps in private projects they're invited to. Private projects show a lock icon next to the name. Only those invited to private Projects will see the Project listed.

Project visibility is configured when you create the Project, but you can switch the visibility later on by clicking on the `...` on any Project page.

<figure><img src="/files/aFw0B0HioZvaNTbQCWEZ" alt=""><figcaption></figcaption></figure>

In both public and private Projects, you can invite external collaborators or existing workspace members to specific projects. To invite collaborators to a Project, click on the Share button in the top right for any Project page.

#### Project permissions

You can fine-tune access to maps in a project by clicking on the **Share** button in the top right for any Project page.

The member who creates the project is by default made a Project Admin. Within each public project the project admin can set a default permission for all members accessing the project. The default permission for each project can be set as: View, Contribute, and Edit.

This default permission can override the member's Workspace-level permission if the default permission grants a lower tier of access level than a member's workspace permission.

For example, if a public project's setting is set to **view**, every member's permission will be view in that project:

* Any **full-seat member** will see the project maps as a **viewer**.
* Any **viewer** will see the project maps as a **viewer**.

Project Admin can override the default permission setting by inviting members individually with custom permissions. This includes inviting other project admin for a single project.

### Project folders

In each project you can create folders to group a collection of maps. Folders organize maps within the same Project. Folders can also be nested.

**To create a folder**

Click on the target project and then click on the icon below in the top-right corner of the page

<figure><img src="/files/b3CPlkEHnI6lnWJel4H4" alt="" width="375"><figcaption></figcaption></figure>

**Moving Maps to Folders**

When moving any map you will see the folders nested under the project in the move modal:

<figure><img src="/files/6zPrwxfEMTQHxa6PdN8p" alt="" width="375"><figcaption></figcaption></figure>

Those invited to the project will have full access to maps in the folder. If you need to control access to maps, create a new project instead.

## FAQ

<details>

<summary>How do I delete a Workspace?</summary>

You can delete workspaces in the settings: <https://felt.com/maps/latest/settings>

Scroll to the bottom and then click "Delete Workspace"

</details>

<details>

<summary>Can I invite other Felt users to a Project even if they aren’t part of the Workspace?</summary>

Yes, this is possible! You can invite collaborators to a specific Project by clicking the Share button when viewing the Project.

</details>

<details>

<summary>I work with different, external clients. How can I invite them to view only relevant maps?</summary>

Create separate projects to organize work with different clients so you can keep maps separate between clients. You can invite clients via email to a Project so they can view all maps within that project. Clients who are invited to a specific project cannot see any other projects or maps in the workspace.

</details>

<details>

<summary>How do I move my maps from one Workspace to another?</summary>

You can copy maps between workspaces in Felt. To get the map into the other account, first make sure you are an editor in both your workspace and the other workspace. Then you can do the following:

1. Open the map
2. Click Felt menu (top left)
3. File
4. Move map... 1.

   ```
   <figure><img src="../.gitbook/assets/image (20).png" alt="" width="310"><figcaption></figcaption></figure>
   ```
5. In the modal select the target workspace (bottom left) 1.

   ```
   <figure><img src="../.gitbook/assets/image (21).png" alt="" width="211"><figcaption></figcaption></figure>
   ```
6. Select a target project
7. Click "Duplicate"

</details>

<details>

<summary>What is the General Project?</summary>

The General Project is a default public Project created for every Workspace.

</details>

<details>

<summary>What do my recent maps show?</summary>

Recent lists all the maps in you have recently viewed or edited. Viewing all maps ("All recent maps") includes public maps you have viewed. This list can be filtered down to show:

* Only the maps you own ("My Recent Maps")
* Maps that belong to the current workspace ("Recent in Workspace")

</details>

<details>

<summary>What are Drafts for?</summary>

Drafts list the maps you created in the current Workspace that do not belong to any particular Project in the Workspace yet. The Draft space is unique to each Editor in the Workspace.

Maps can moved from Drafts into Projects that Editor has access to, which will share visibility and access to everyone belonging to that Project.

</details>

<details>

<summary>Who can see maps that are in my Drafts?</summary>

**Only you can see maps in your drafts**, **even if you are in a shared workspace.** The only way someone could view a map in drafts is if you shared the map with them.

</details>

<details>

<summary>What’s the difference between Recents and Drafts?</summary>

Drafts only show maps you own and don’t belong to any projects yet. Recents show maps you have viewed and/or edited.

</details>

<details>

<summary>How can I change the name of the project?</summary>

Double-click on the name of the project to edit it.

</details>

<details>

<summary>How do I convert a public Project to private, and vice versa?</summary>

Navigate to the Project in Felt, click on the `...` in the top-right corner and select **`Make Private`** or **`Make Public`**

</details>

<details>

<summary>How do I delete my Felt account?</summary>

To delete your account, please reach out to <support@felt.com>

</details>

<details>

<summary>How do I change my account email address?</summary>

To switch or change the email address for your account, navigate to <https://felt.com/users/settings>.

1. Click on your email address (you may be prompted to set a password first)
2. Enter your new email address
3. Click the confirmation link in the email sent to the new email address

{% hint style="info" %}
Felt treats certain email variations as duplicates to prevent multiple accounts.
{% endhint %}

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.felt.com/administration/workspaces-and-projects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.