Projects
Create a project, slug rules, the dev and prod environments created with it, and renaming or deleting projects.
A project is the unit of work for a team or a product. Each project has its own environments, data sources, actions, views, jobs and audit log. Users only see the projects they are linked to.
Required roles
Section titled “Required roles”| Action | Role |
|---|---|
| Create a project | Owner |
| Rename a project | Project Admin, Owner |
| Delete a project | Owner |
| Open a project | Everyone linked to it (Owners see every project) |
Create a project
Section titled “Create a project”- In Organization admin, open Projects (or Overview) and click New project.
- Enter a Name, for example
Support Tools. - Enter a Slug, for example
support-tools. A slug can contain only lowercase letters, digits and hyphens, cannot start or end with a hyphen, and is at most 64 characters long. The slug cannot be changed after the project is created. - Click New project in the dialog. The new project’s Overview page opens with the setup checklist. See Quickstart.
Every new project comes with two environments:
| Slug | Name | Production | Access |
|---|---|---|---|
dev | Development | No | open: every member |
prod | Production | Yes | restricted: only owners, admins and granted users |
Add more environments (for example staging) on the Environments page. See Environments.
Project list
Section titled “Project list”- Owners see every project in the organization, with each project’s member count.
- Other users see only the projects they are linked to, with their role. If they are not linked to any project, the page shows the message “You’re not linked to any project yet. Ask your organization owner to add you.”
Inside a project, switch to another project with the project switcher in the top bar (All projects…).
For Admins and Owners, the … button on each row offers Open project, Access, Rename and Delete project (Owners only).
Rename a project
Section titled “Rename a project”Choose … > Rename, enter the new name and click Save. The slug does not change, so links and scripts that use it keep working.
Delete a project
Section titled “Delete a project”- Choose … > Delete project on the project’s row.
- Type the project’s slug exactly into the confirmation box.
- Click Delete project.