Project Settings
Configure project preferences, notifications, and integrations
Project Settings
Project settings allow you to customize how your project works. Access settings via the gear icon on any project page or through Project > Settings.
General Settings
Basic Information
Project Name
- Change the display name (key remains unchanged)
- 2-100 characters allowed
Description
- Markdown-supported project description
- Displayed on project dashboard
Project Icon
- Choose from icon library
- Upload custom icon (PNG, 128x128px max)
Theme Color
- Select primary color for project elements
- Used in navigation and cards
Project Status
Change project lifecycle status:
| Status | Effect | |--------|--------| | Active | Normal operation | | On Hold | Visible warning badge, no new sprints | | Completed | Marked as done, read-only by default | | Archived | Hidden from main views |
Danger Zone
Transfer Project
- Move to different space
- Requires admin in both spaces
Archive Project
- Removes from active list
- Preserves all data
- Can be unarchived
Delete Project
- Permanent deletion
- Requires confirmation
- Cannot be undone
Access & Permissions
Elixion has no project visibility setting — there's no Public/Private/
Restricted mode to configure here. Access is determined by project
membership. See Permissions for the real role
model (OWNER/ADMIN/VIEWER plus job-function roles), and the note there
about the planned org boundary (ELI-1284), which has not shipped.
There is no configurable per-role permission matrix and no "Manager" role — those do not exist in the product today.
Issue Settings
Issue Types
Enable/disable issue types for this project:
- Epic - Large features spanning multiple sprints
- Story - User-facing functionality
- Task - Technical or administrative work
- Bug - Defects and issues
- Tech Debt - Technical improvements
- Spike - Research and investigation
Custom Fields
Add project-specific fields:
Field Types: | Type | Use Case | |------|----------| | Text | Free-form input | | Number | Numeric values | | Dropdown | Predefined options | | Multi-select | Multiple options | | Date | Date values | | User | Team member reference | | URL | Links | | Checkbox | Boolean flags |
Creating a Custom Field:
- Click Add Field
- Enter field name
- Select field type
- Configure options (if dropdown)
- Set as required (optional)
- Save
Default Values
Set defaults for new issues:
- Priority: Medium
- Type: Task
- Assignee: Creator
- Labels: None
Templates
Configure issue templates:
- Go to Issue Templates
- Click Create Template
- Define template structure
- Set for specific issue types
Board Settings
Columns
Configure board columns:
Add Column:
- Click + Add Column
- Enter column name
- Map to status(es)
- Set WIP limit (optional)
Column Properties:
- Name
- Mapped statuses
- WIP limit
- Definition of done
- Color
Swimlanes
Organize board by:
- None - Single lane
- Assignee - Group by person
- Priority - Group by urgency
- Epic - Group by parent epic
- Type - Group by issue type
Card Display
Choose what appears on cards:
- ☑ Assignee avatar
- ☑ Priority indicator
- ☑ Story points
- ☑ Due date
- ☐ Labels
- ☐ Epic badge
Quick Filters
Pre-defined filter buttons:
- My Issues
- Unassigned
- High Priority
- Due This Week
Sprint Settings
Sprint Duration
Set default sprint length:
- 1 week
- 2 weeks (recommended)
- 3 weeks
- 4 weeks
- Custom
Estimation
Configure estimation approach:
Story Points
- Fibonacci: 1, 2, 3, 5, 8, 13, 21
- Powers of 2: 1, 2, 4, 8, 16
- T-Shirt: XS, S, M, L, XL
Time Estimates
- Hours
- Days
- Off
Velocity Calculation
- Rolling average (last 3 sprints)
- All-time average
- Manual override
Notifications
Project Notifications
Configure what triggers notifications:
| Event | Email | In-App | Slack | |-------|-------|--------|-------| | Issue created | ☐ | ☑ | ☑ | | Issue assigned | ☑ | ☑ | ☑ | | Comment added | ☐ | ☑ | ☐ | | Status changed | ☐ | ☑ | ☑ | | Sprint started | ☑ | ☑ | ☑ | | Sprint completed | ☑ | ☑ | ☑ |
Notification Channels
Email Digest
- Instant
- Daily summary
- Weekly summary
- Off
Slack Channel Set default channel for project notifications.
Integrations
GitHub
Repository Linking
- Connect one or more repositories
- Auto-link commits mentioning issue keys
- Pull request integration
Branch Settings
- Default branch name pattern:
feature/AUTH-{issue_number} - Auto-create branches from issues
Auto-close Issues
- Close issues when PR is merged
- Transition to specific status
Slack/Teams
Channel Configuration
- Default notification channel
- Separate channels for alerts vs. updates
Bot Commands Enable slash commands in connected channels.
Webhooks
Add custom webhooks:
- Click Add Webhook
- Enter webhook URL
- Select events to send
- Configure headers (optional)
- Test and save
Automation
Rules
Create automation rules:
Trigger → Condition → Action
Example Rules:
When: Issue moved to "Done"
If: Issue type is "Bug"
Then: Add label "Fixed"
When: Issue created
If: Title contains "[URGENT]"
Then: Set priority to "Critical", Notify #urgent-bugs
Available Actions
- Change status
- Add/remove labels
- Assign to user
- Set field value
- Send notification
- Create sub-task
- Call webhook
Next: Spaces - Organize projects into workspaces