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:

  1. Click Add Field
  2. Enter field name
  3. Select field type
  4. Configure options (if dropdown)
  5. Set as required (optional)
  6. Save

Default Values

Set defaults for new issues:

  • Priority: Medium
  • Type: Task
  • Assignee: Creator
  • Labels: None

Templates

Configure issue templates:

  1. Go to Issue Templates
  2. Click Create Template
  3. Define template structure
  4. Set for specific issue types

Board Settings

Columns

Configure board columns:

Add Column:

  1. Click + Add Column
  2. Enter column name
  3. Map to status(es)
  4. 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:

  1. Click Add Webhook
  2. Enter webhook URL
  3. Select events to send
  4. Configure headers (optional)
  5. 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