# Workspace projects Source: https://docs.arcweave.com/workspaces/projects Section: Workspaces Description: Create, import, duplicate, rename, and delete workspace projects, use project templates, and manage project covers An Arcweave **project** is a self-contained unit that holds the structure, content, and assets of an interactive story. It allows you to design, test, share, and export your work. Projects include [project items](https://docs.arcweave.com/project-items/overview) such as boards, elements, and components, and support both collaboration and external integration. The **Projects** section displays the workspace's projects. ![The Projects section of a workspace with multiple project thumbnails.](https://docs.arcweave.com/assets/projects.BM3m9Naf.png) > ℹ️ Guests only see the projects they have been invited to. ## Project thumbnails Context: Arcweave docs > Workspaces > Workspace projects > Project thumbnails All the workspace projects are shown as **thumbnails** in a grid. You can access project-specific options through the [menu](https://docs.arcweave.com/workspaces/projects#project-menu) on each thumbnail. ## Search Context: Arcweave docs > Workspaces > Workspace projects > Search Use the **search** field to quickly filter projects by title. ## Create projects Context: Arcweave docs > Workspaces > Workspace projects > Create projects To create a new project: 1. Go to the **Projects** section of your workspace. 2. Click the **+ New Project** button. 3. Select **Blank Project** among the available project templates. ![Arcweave workspace screenshot, with the "New Project" button highlighted.](https://docs.arcweave.com/assets/workspaces-new-project.DPv-Ss89.png) A new project will be created and automatically opened. > ℹ️ Basic workspaces can have up to 3 projects. > ✅ You can also [import a project](https://docs.arcweave.com/workspaces/projects#import-projects) into your workspace. Use the search field or the **All templates**, **Examples**, and **Game Engines** tabs to filter the available templates. ## Project templates Context: Arcweave docs > Workspaces > Workspace projects > Project templates Arcweave includes built-in project templates that you can recreate to expand and learn from. To create a project from one of the templates: 1. Go to the workspace's **Projects** section. 2. Click the **+ New Project** button. 3. Select a template from the menu. ![The Projects section of an Arcweave workspace, with the "Create project" modal open, showing the available project templates.](https://docs.arcweave.com/assets/project-templates.cASA2VSk.png) Current built-in templates include: - **Blank Project**: an empty project for starting from scratch. - **Interactive Fiction Example**: a simple example of Arcweave's basic flowchart and story features. - **Interactive Movie Example**: an example of an interactive short film using video assets. - **Game Engine Example**: the project used in the game engine integration tutorials. - **Tabletop Campaign Example**: a simple campaign structure with dice rolling. - **Visual Novel Example**: a tutorial-style visual novel with characters, backgrounds, and audio. - **Serious Games Example**: simulated email-based security training with custom Play Mode CSS. > ✅ Try the _Game Engine Example_ to see how Arcweave [integrates with popular game engines](https://docs.arcweave.com/integrations/overview). Watch the video tutorials on the [Unreal](https://docs.arcweave.com/tutorials/unreal/overview) and [Godot](https://docs.arcweave.com/tutorials/godot/overview) plugins to get a glimpse of such integrations. ## Import projects Context: Arcweave docs > Workspaces > Workspace projects > Import projects The [Import projects permission](https://docs.arcweave.com/workspaces/roles#list-of-permissions) allows users to import projects into a workspace. - Arcweave JSON files can be imported into any workspace, as long as the import stays within the workspace's project and item limits. - Native Arcweave backup files (`.arcw`) can also be imported into [Pro and Team](https://docs.arcweave.com/workspaces/billing-plans) workspaces. - In Team workspaces, projects can also be imported using Arcweave's [REST API](https://docs.arcweave.com/rest-api/overview). ### Arcweave JSON Context: Arcweave docs > Workspaces > Workspace projects > Import projects > Arcweave JSON You can also import a project from an **Arcweave JSON** file (`.json`) that was either previously [exported from Arcweave](https://docs.arcweave.com/project-tools/export#export-as-json) or otherwise generated, as long as it follows the [Arcweave JSON format](https://docs.arcweave.com/integrations/json). > ⚠️ JSON import does not restore assets, element and component covers, element audio, or Asset List attribute values, and every item ID must be a UUIDv4. See [Arcweave JSON](https://docs.arcweave.com/integrations/json) for details. > ✅ If the JSON includes board item coordinates (e.g. it were [exported](https://docs.arcweave.com/project-tools/export#include-coordinates) with **Include coordinates** enabled), board items will be restored to their original positions and sizes upon import. ### Arcweave file Context: Arcweave docs > Workspaces > Workspace projects > Import projects > Arcweave file An **Arcweave file** (`.arcw`) is the native backup format used by Arcweave. It contains the complete project data, including notes, comments, and assets, as well as positions of all board items. To generate an Arcweave file, [export a project as a backup](https://docs.arcweave.com/project-tools/export#export-project-backup). > ⚠️ Importing `.arcw` backup files is available in [Pro and Team](https://docs.arcweave.com/workspaces/billing-plans) workspaces. ### REST API Context: Arcweave docs > Workspaces > Workspace projects > Import projects > REST API In Team workspaces, you can also import projects using the [Import project endpoint](https://docs.arcweave.com/rest-api/projects#import-project) of Arcweave's **REST API**. ### Import a project Context: Arcweave docs > Workspaces > Workspace projects > Import projects > Import a project To import a project into your workspace: 1. Go to the **Projects** section of your workspace. 2. Click the **Import** button at the top right. 3. Choose the file format you want to import. 4. Select the file from your device and upload it. ![The Projects section of an Arcweave workspace, with an orange arrow pointing at the "Import" button at the top right of the screen.](https://docs.arcweave.com/assets/import-project.CzEYalxL.png) Once the import is complete, the project will appear in your workspace's Projects list. > ℹ️ Imported projects are named `Imported - ` followed by the original project name. Because project names are limited to 255 characters, the original name can be up to 244 characters. ## Invite people Context: Arcweave docs > Workspaces > Workspace projects > Invite people Click the **invite** button (person icon with a plus) at the top right to invite team [members](https://docs.arcweave.com/workspaces/people#add-members) to your workspace. This button requires the **Manage memberships** permission. ## Project menu Context: Arcweave docs > Workspaces > Workspace projects > Project menu From the **Projects** section, you can open the menu for any project to perform the following actions: - Delete - Duplicate (Pro and Team workspaces only) - Rename - Upload/Change cover - Remove cover (if any) - Move to workspace The actions shown depend on your permissions. **Duplicate** requires **Duplicate projects**, **Delete** requires **Delete projects**, and **Move to workspace** requires **Move project**. Renaming and cover actions require **Edit projects**. As the [project owner](https://docs.arcweave.com/workspaces/roles#project-owner), you can also duplicate or delete projects you created. ### Open project menu Context: Arcweave docs > Workspaces > Workspace projects > Project menu > Open project menu Once in the **Projects** section, open the menu for a project as follows: 1. Hover over the project's thumbnail. 2. Click the **•••** icon that appears at its top-right corner. 3. Select the action you want to perform from the menu. Or: 1. Right-click the thumbnail. 2. Select the action you want to perform from the menu. ## Delete projects Context: Arcweave docs > Workspaces > Workspace projects > Delete projects To delete a project: 1. Go to the workspace's **Projects** section. 2. Open the project's menu using the **•••** icon or by right-clicking the thumbnail. 3. Select **Delete**. 4. Click **Delete** to confirm. > ⚠️ Deleting a project is permanent and _cannot be undone._ ## Duplicate projects Context: Arcweave docs > Workspaces > Workspace projects > Duplicate projects Pro and Team workspaces include the feature of project duplication. To duplicate a project: 1. Go to the workspace's **Projects** section. 2. Open the project's menu using the **•••** icon or by right-clicking the thumbnail. 3. Select **Duplicate**. ## Rename projects Context: Arcweave docs > Workspaces > Workspace projects > Rename projects To rename a project: **While the project is open**: Click the project's name at the top left of the window. **From within the workspace**: 1. Go to the workspace's **Projects** section. 2. Open the project's menu using the **•••** icon or by right-clicking the thumbnail. 3. Select **Rename**. 4. Type a new name for the project and press **Enter**. Project names can be up to 255 characters long. ## Project cover Context: Arcweave docs > Workspaces > Workspace projects > Project cover You can add, change, or remove a project's **cover image** from the **Projects** section. ### Add project covers Context: Arcweave docs > Workspaces > Workspace projects > Project cover > Add project covers 1. Go to the workspace's **Projects** section. 2. Open the project menu via **•••** or right-click. 3. Select **Upload cover** and choose an image. Project cover images can be `.jpg`, `.jpeg`, or `.png` files, up to **3 MB** and at least 128 x 128 pixels. ### Change project covers Context: Arcweave docs > Workspaces > Workspace projects > Project cover > Change project covers 1. Go to the workspace's **Projects** section. 2. Open the project menu. 3. Select **Change cover** and choose a new image. ### Remove project covers Context: Arcweave docs > Workspaces > Workspace projects > Project cover > Remove project covers 1. Go to the workspace's **Projects** section. 2. Open the project menu. 3. Select **Remove cover**. ## Move projects Context: Arcweave docs > Workspaces > Workspace projects > Move projects To move a project from one workspace to another: 1. Go to the workspace's **Projects** section. 2. Open the project menu. 3. Select **Move to workspace**. 4. Select the target workspace from the dropdown menu and press **Move**. > ℹ️ Moving projects requires **Move project** permission in the source workspace and **Create projects** permission in the target workspace. The target workspace must also have room for the project under its project and item limits. ## Open projects Context: Arcweave docs > Workspaces > Workspace projects > Open projects From the **Projects** section, click a project's thumbnail to open the project. ## Exit projects Context: Arcweave docs > Workspaces > Workspace projects > Exit projects From within a project, click the **Workspace** icon at the top left of the window (next to the project name) to return to the workspace.