Creating and Managing Workspaces
Learn how to create new workspaces, update settings, upload logos, and delete workspaces in Devpilot.
Creating and Managing Workspaces
Devpilot allows you to create as many workspaces as your plan permits. Each workspace provides an isolated environment with its own team, resources, billing, and settings. This guide covers how to create, configure, search, and delete workspaces.
Creating a New Workspace
Navigate to the Workspaces Page
Go to /dashboard/workspaces in Devpilot. This page lists all workspaces you currently own or belong to.
Click "Create Workspace"
Select the Create Workspace button at the top of the workspaces list. This opens the workspace creation form.
Enter Workspace Details
Fill in the following fields:
- Workspace Name (required) — a descriptive name between 3 and 255 characters (e.g., "Acme Corp Production" or "Personal Projects"). This name appears throughout Devpilot wherever the workspace is referenced.
- Description (optional) — up to 1000 characters describing the workspace's purpose.
- Workspace Logo (optional) — upload an image to visually identify this workspace. Supported formats are JPEG, JPG, PNG, GIF, WebP, and SVG, up to 5 MB.
Confirm Creation
Click Create to finalize the workspace. Devpilot creates the workspace and redirects you to its Overview page. You are automatically assigned as the Owner of the new workspace.
As the workspace Owner, you have full control over all resources, settings, team members, and billing. You can begin inviting team members and adding resources immediately after creation.
Editing Workspace Settings
You can update your workspace's configuration at any time through the Settings page. Only workspace Owners and Admins can edit settings.
Open Workspace Settings
Navigate to your workspace and select Settings from the sidebar menu. The settings page displays all configurable options for the workspace.
Update Workspace Name
To rename your workspace, edit the Workspace Name field and save your changes. The new name takes effect immediately and appears across all pages, notifications, and references to this workspace.
Upload or Change the Workspace Logo
In the logo section, click the upload area to select a new image file, or drag and drop an image directly. The logo appears in the workspace switcher, sidebar, and team views. To remove the current logo, click the Remove option next to the image preview.
Save Changes
Click Save to apply your updates. All workspace members see the updated name and logo the next time they load the workspace.
Additional Settings
The workspace Settings page also provides access to:
- General settings — workspace-level preferences such as notifications and automatic backups.
- Access Tokens — create personal, scoped tokens for scripts and CI/CD pipelines. See Access Tokens and API Keys.
- API Keys — create workspace-level keys for service-to-service integrations.
- Integrations — manage connected third-party services such as Git providers, cloud accounts, and notification channels.
- Billing — view and manage the workspace's subscription plan, payment methods, and usage details.
- Danger zone — options for deleting the workspace.
Searching and Filtering Workspaces
If you belong to multiple workspaces, the workspaces list page at /dashboard/workspaces provides tools to find the one you need.
Search by Name
Use the search bar at the top of the workspace list to filter workspaces by name. The list updates in real time as you type.
Filter by Role
You can filter the workspace list to show only workspaces where you hold a specific role:
- All — displays every workspace you belong to.
- Owned — shows workspaces where you are the Owner.
- Member — shows workspaces where you joined as an Admin or Member.
Sort Options
Sort your workspace list by:
- Name (alphabetical)
- Date created (newest or oldest first)
- Last accessed (most recently visited first)
Switching Between Workspaces
Devpilot provides a workspace switcher accessible from the sidebar or top navigation bar. Click the current workspace name to open a dropdown list of all your workspaces. Select a different workspace to switch context immediately. All navigation, resources, and team views update to reflect the selected workspace.
Deleting a Workspace
Deleting a workspace is a permanent, destructive action. It removes the workspace and all of its contents — projects, apps, servers, deployment history, integrations, and team associations.
Workspace deletion is irreversible. All resources, data, deployment history, and team associations within the workspace are permanently removed. This action cannot be undone.
Navigate to Workspace Settings
Open the workspace you want to delete and go to Settings from the sidebar.
Scroll to the Danger Zone
At the bottom of the Settings page, locate the Danger Zone section.
Initiate Deletion
Click the Delete Workspace button. Devpilot displays a confirmation dialog that requires you to type the workspace name to proceed.
Confirm Deletion
Type the full workspace name exactly as shown to confirm. Click Delete to permanently remove the workspace. You are redirected to the workspaces list page.
Only the workspace Owner can delete a workspace. Admins and Members do not have permission to perform this action. If you need to delete a workspace you do not own, contact the workspace Owner.
Best Practices
- Use descriptive names — workspace names like "Client X - Production" or "Internal Tools - Staging" make it clear what each workspace is for at a glance.
- Upload logos — visual identifiers make switching between workspaces faster and reduce the chance of performing actions in the wrong workspace.
- Limit workspace proliferation — create new workspaces when you need genuine isolation (separate teams, billing, or clients), not for every minor project. Use projects within a workspace to organize related apps.
- Review before deleting — always verify that a workspace has no active, in-use resources before deleting it. Consider exporting important data or configuration first.