Projects
A Project groups all of a team's work - issues, sprints, boards, and settings - into a single collaborative space within the organization.
Creating a Project
- In the sidebar, click + New Project.
- Enter the project name.
- Choose the type (see below).
- Set the visibility.
- Click Create Project.
Project Types
| Type | Recommended Use |
|---|---|
| SOFTWARE | Software development, agile sprints, and releases |
| BUSINESS | Process management, administrative tasks, and operations |
| KANBAN | Continuous flow without fixed sprints |
| SCRUM | Iterative development with Scrum sprints |
| CUSTOM | Fully customized configuration |
The type determines the default templates for issue types, priorities, and workflow created during initial project setup.
Visibility
| Level | Who can view? |
|---|---|
| Private | Only explicitly added project members |
| Public (Org) | All organization members |
| Public | Anyone with the link (no authentication required) |
Public projects allow visitors without an account to view the board and issues, but they cannot create, edit, or move items.
Project Members
Project Roles
| Role | Permissions |
|---|---|
| PROJECT_ADMIN | Full control: settings, workflow, sprints, members, webhooks, and project deletion. |
| DEVELOPER | Create and edit issues, manage sprints, and interact with the board. |
| REPORTER | Create issues only; cannot edit project settings. |
| VIEWER | Read-only: view issues and boards, no creation or modification. |
Adding Members
- Go to Project → Settings → Members.
- Search for a member by name or email.
- Select the desired role and click Add.
You can also add an entire Profile Group, granting the selected role to all group members at once.
Project Settings
The Settings menu of each project provides:
- General - name, description, type, and visibility
- Board - columns, transitions, WIP limits
- Workflow - statuses and transitions
- Issue Types - issue categories
- Priorities - urgency levels
- Notifications - event-based notification rules
- Webhooks - external system integrations
- Attachments - enable/disable and max per issue
- Public Tokens - unauthenticated access links
See the Settings page for full details.
Project Avatar
Each project can have a custom avatar (built-in icon or uploaded image). The avatar appears in the sidebar and project headers.
To change: Settings → General → Avatar.
Archiving a Project
Archived projects become read-only. No data is lost. To archive:
- Go to Project → Settings → General.
- Click Archive Project and confirm.
To restore, click Restore Project.
Deleting a Project
⚠️ Irreversible action. All issues, sprints, and project data will be permanently removed.
Only a Manager can delete the project at Settings → Danger Zone → Delete Project.