Timeline View

The Timeline view provides a Gantt-style visualization of your project's work over time. It helps with planning, dependency tracking, and understanding project schedules.

Timeline Overview

Visual Structure

                    Jan                      Feb
            W1    W2    W3    W4    W1    W2    W3
           ────┼─────┼─────┼─────┼─────┼─────┼─────┼────
Epic: Auth │████████████████████████│
├─ Story 1 │████████│
├─ Story 2 │        │████████│
├─ Story 3 │        │        │██████████████│
└─ Story 4 │                       │████████│

Epic: UI   │                │████████████████████│
├─ Story 5 │                │████████│
└─ Story 6 │                        │████████│

Legend: ████ = Duration  │ = Dependency

Accessing Timeline

1. From Sidebar: Click Board → Switch to Timeline
2. From Project: Project page → Timeline tab
3. Keyboard: Press T on project page

Timeline Elements

Issue Bars

Each issue appears as a horizontal bar:

┌──────────────────────────────────┐
│ AUTH-100: Login Implementation   │ 5 pts
└──────────────────────────────────┘
 Jan 8                          Jan 19

Bar Information:

• Length = Duration (start to end date)
• Color = Issue type or status
• Label = Issue key and title
• Points = Story points (if enabled)

Progress Indication

Shows completion within the bar:

│████████████░░░░░░│  60% complete
 ▲─────────▲
 Completed  Remaining

Dependencies

Arrows show relationships:

AUTH-100 ────────►
                  ╲
                   ╲───► AUTH-101 ────────►

Timeline Navigation

Zoom Levels

| Level | Shows | Best For | |-------|-------|----------| | Day | Hours | Daily planning | | Week | Days | Sprint view | | Month | Weeks | Project overview | | Quarter | Months | Roadmap | | Year | Quarters | Long-term planning |

Change Zoom:

• Scroll with Ctrl/Cmd held
• Use zoom buttons
• Select from dropdown

Scrolling

• Horizontal: Click and drag, or scroll
• Vertical: Regular scroll
• Pan: Middle mouse button

Today Line

Red vertical line marks current date:

        │ ← Today
────────│────────────
████████│░░░░░░░░░░░

Creating Timeline Items

Set Dates

For items to appear on timeline:

1. Open issue
2. Set Start Date
3. Set Due Date
4. Issue appears on timeline

Drag to Create

1. Click on empty timeline space
2. Drag to set duration
3. Release to create issue
4. Fill in details

Resize Duration

Drag edges to adjust dates:

←│████████████████│→
 Drag left     Drag right
 (change start) (change end)

Move Issues

Drag the bar to change dates while keeping duration:

Before: │████████│
                    ↓ Drag right
After:      │████████│

Organizing the Timeline

Grouping

Group issues by:

By Epic:

Epic: Authentication
├── AUTH-100
├── AUTH-101
└── AUTH-102

Epic: User Interface
├── UI-200
└── UI-201

By Assignee:

Alice
├── AUTH-100
└── UI-200

Bob
├── AUTH-101
└── AUTH-102

By Sprint:

Sprint 14
├── AUTH-100
├── AUTH-101
└── UI-200

Sprint 15
├── AUTH-102
└── UI-201

Expanding/Collapsing

• Click ► to expand group
• Click ▼ to collapse
• Ctrl + Click to expand/collapse all

Row Height

Adjust density:

• Compact: More items visible
• Normal: Balanced view
• Expanded: More detail per item

Working with Dependencies

Viewing Dependencies

Dependencies shown as arrows:

AUTH-100 ───────────────┐
                        ▼
           AUTH-101 ────────────

Types:

• Solid arrow: Blocks
• Dashed arrow: Related

Creating Dependencies

1. Hover over issue end
2. Click dependency connector
3. Drag to target issue
4. Select relationship type

Dependency Warnings

Visual indicators for issues:

⚠️ AUTH-101: Starts before blocker ends
   Blocked by: AUTH-100 (ends Jan 15)
   Current start: Jan 12

❌ AUTH-102: Circular dependency detected

Timeline Analysis

Critical Path

Highlight the longest dependency chain:

Critical Path (shown in red):
AUTH-100 → AUTH-101 → AUTH-103 → AUTH-105
           ↓
          (Total: 25 days)

Milestone Markers

Add milestones to timeline:

           Jan 15        Jan 31
              ◆            ◆
           Sprint       Release
           Review       v2.0

Capacity View

Overlay team capacity:

Week of Jan 8:
Assigned:  ████████████░░░░░░  75%
Capacity:  ████████████████████  100%

Filtering Timeline

Quick Filters

• My Issues - Show your assigned items
• This Sprint - Current sprint only
• Critical Path - Show critical items
• Overdue - Past due date

Advanced Filters

Filter by:

• Epic
• Assignee
• Priority
• Type
• Labels
• Status

Hide Completed

Toggle to hide done items:

• Show all issues
• Hide completed issues
• Show completed in gray

Exporting Timeline

Image Export

1. Click Export
2. Select Image
3. Choose format (PNG, SVG)
4. Download

PDF Export

1. Click Export
2. Select PDF
3. Configure:
   • Page size
   • Orientation
   • Date range
4. Download

Calendar Integration

Export to external calendars:

• iCal format
• Google Calendar link
• Outlook integration

Best Practices

Effective Planning

✓ Do:

• Set realistic durations
• Include buffer time
• Track dependencies
• Update dates regularly

✗ Don't:

• Over-schedule
• Ignore dependencies
• Let dates go stale
• Skip milestones

Timeline Hygiene

• Review weekly
• Update completed items
• Adjust estimates
• Communicate changes

---

Next: Roadmap - Long-term planning view