Creating Projects
Step-by-step guide to creating and configuring new projects in Elixion
Creating Projects
This guide walks you through creating a new project in Elixion, from initial setup to team configuration.
Quick Create
The fastest way to create a project:
- Click the + button in the Projects list
- Enter project name
- Enter project key (auto-suggested based on name)
- Click Create
Your project is ready to use with default settings.
Detailed Setup
For more control over your project configuration:
Step 1: Basic Information
Navigate to Projects > Create Project or use the project creation wizard.
Required fields:
- Name - Descriptive project name (2-100 characters)
- Key - Unique identifier for issues (2-10 uppercase letters)
Optional fields:
- Description - Project overview and goals
- Space - Workspace to organize the project
- Icon - Visual identifier
- Color - Theme color for the project
Step 2: Choose a Template
Start with a pre-configured template or blank project:
Available Templates
| Template | Best For | Includes | |----------|----------|----------| | Blank | Custom setup | Empty project | | Scrum | Agile teams | Sprints, story points, ceremonies | | Kanban | Continuous flow | Board with WIP limits | | Bug Tracking | QA teams | Bug-specific fields and workflows | | Product Roadmap | Product teams | Epics, milestones, timeline |
Template Details
Scrum Template
- Sprint board with standard columns
- Story point estimation
- Velocity tracking
- Sprint ceremonies integration
Kanban Template
- Continuous flow board
- WIP limit configuration
- Cycle time metrics
- Cumulative flow diagram
Bug Tracking Template
- Bug-specific issue types
- Severity and priority fields
- Environment and version tracking
- Reproduction steps templates
Step 3: Configure Board
Set up your initial board configuration:
Columns Default columns are provided based on template. Customize by:
- Adding new columns
- Renaming existing columns
- Setting column limits
- Defining done criteria
Default Column Set:
To Do → In Progress → In Review → Done
Status Mapping Map issue statuses to board columns:
| Status | Column | |--------|--------| | Open, Backlog | To Do | | In Progress | In Progress | | In Review | In Review | | Done, Closed | Done |
Step 4: Issue Configuration
Configure issue types and fields:
Enable Issue Types:
- ☑ Epic
- ☑ Story
- ☑ Task
- ☑ Bug
- ☐ Tech Debt
- ☐ Spike
Custom Fields: Add project-specific fields:
- Text fields
- Number fields
- Dropdown selections
- Date fields
- User references
Step 5: Team Setup
Add team members to the project:
- Click Add Members
- Search for users or teams
- Assign roles:
- Admin - Full control
- Manager - Sprint and team management
- Developer - Standard access
- Viewer - Read-only
Bulk Import:
- Import from CSV
- Import from another project
- Import from organization groups
Step 6: Integrations
Connect external services:
GitHub Integration
- Link repositories
- Enable auto-linking commits
- Configure branch rules
Slack/Teams
- Set notification channel
- Configure alert triggers
Webhooks
- Add custom webhook URLs
- Select events to broadcast
Step 7: Review and Create
Before creating, review your configuration:
Project Summary
─────────────────
Name: User Authentication Service
Key: AUTH
Space: Backend Services
Template: Scrum
Team: 5 members
Integrations: GitHub, Slack
Click Create Project to finish.
Post-Creation Setup
After creating your project:
Populate the Backlog
- Create initial epics for major features
- Break down into stories
- Add acceptance criteria
- Estimate story points
Plan First Sprint
- Define sprint duration
- Set sprint goal
- Pull items from backlog
- Assign to team members
Configure Automation
- Set up status transitions
- Configure notifications
- Enable auto-assignment rules
Project from Template
Create a project based on an existing project:
- Go to Projects > New from Template
- Select source project
- Choose what to copy:
- ☑ Board configuration
- ☑ Issue types and fields
- ☑ Automation rules
- ☐ Issues (optional)
- ☐ Team members (optional)
- Enter new project details
- Create
Import Project
Import from external systems:
From Jira
- Export project from Jira (JSON format)
- Go to Projects > Import
- Select Jira as source
- Upload export file
- Map fields and users
- Import
From GitHub Issues
- Go to Projects > Import
- Select GitHub as source
- Authenticate and select repository
- Configure import options
- Import
From CSV
- Prepare CSV with required columns
- Go to Projects > Import > CSV
- Upload file
- Map columns to fields
- Preview and import
Troubleshooting
"Key already exists"
Project keys must be unique. Try:
- Using a different abbreviation
- Adding a number suffix
- Checking archived projects
"Insufficient permissions"
You need Create Project permission. Contact your admin.
"Template not available"
Some templates require specific plan tiers. Check your subscription.
Next: Project Settings - Configure project preferences