Project Types
The Project Types page is the management list for reusable project-type definitions used when creating projects. Each type defines the metadata (name, icon, color) and the ordered schema of work-item types that projects of that type can contain.
Accessing the Page
Section titled “Accessing the Page”Open Projects from the sidebar and navigate to Settings → Project Types. Visibility requires at least Read-level access to the projects.project_types permission.
List Contents
Section titled “List Contents”Each project type card shows:
- Icon and color chip
- Name and machine-readable key
- Optional description
- Work-item type badges showing the schema preview in sort order
Actions
Section titled “Actions”| Action | Required Permission | Description |
|---|---|---|
| + New Project Type | Write (project_types) | Opens the Project Type Editor at /projects/types/new |
| Edit (pencil icon per card) | Write (project_types) | Opens the Project Type Editor at /projects/types/:id/edit |
| Delete (trash icon per card) | Admin (project_types) | Opens a confirmation dialog; soft-delete behavior means the type is removed from the catalog |
Permissions
Section titled “Permissions”| Access level | What the user can do |
|---|---|
| Read | View the catalog and inspect work-item schema badges |
| Write | Create and edit project types |
| Admin | All Write actions plus delete project types |
Superusers bypass permission checks and have full access.
Without any permission, the page is visible as a read-only catalog.
Pagination
Section titled “Pagination”The list loads 25 project types per page. A Load more button appears when more types are available. The page refreshes via the toolbar refresh button, and module queries are invalidated after any create, edit, or delete so all dependent views stay consistent.
Related Pages
Section titled “Related Pages”- Project Type Editor — Create or edit a project type and its work-item schema
- Projects List — Create a project using a defined project type