Skip to content
Ekko
Start here All docs

Getting started with Ekko

Install Ekko in your Jira site, run the onboarding wizard, and find your way around the home dashboard and side navigation.

Reading time
5 min read
For
Everyone using Ekko for the first time.

Ekko is a Jira Cloud app that brings sprint planning, capacity tracking, bulk task creation, sprint poker, and team/time-off management into a single page inside Jira. You do not need to switch tools — Ekko reads from and writes to Jira directly.

This guide walks you through your very first session: installing the app, completing the onboarding wizard, and landing on the home dashboard with everything wired up.

1. Install Ekko in your Jira site

Ekko is distributed through the Atlassian Marketplace. A Jira admin needs to install it on the site once; after that every user in the site can open it from the Apps menu.

  1. 1
    Open the Marketplace listing From any Jira page, click Apps → Find new apps and search for "Ekko". Or visit the Marketplace listing directly.
  2. 2
    Click "Get it now" Confirm the Forge scopes Ekko asks for (sprint and issue read/write, project/board read, app-scoped storage). These are required for Ekko to read your boards and update Jira on your behalf.
  3. 3
    Wait for the install to finish Forge provisions a small database for Ekko inside your tenant on first install. The progress bar usually completes in under a minute.
  4. 4
    Open Ekko Apps → Ekko. The launcher bounces you into the full-page Ekko surface — this is where you will live for the rest of this guide.

2. The very first time you open Ekko

The first time any user in your site opens Ekko, the app shows the onboarding wizard. It is designed to take three or four minutes and prefills sensible defaults so you can blast through it if you want to.

Onboarding has four steps:

  1. General — pick a theme (light, dark, or follow your OS).
  2. Sprint planning — pick capacity mode (hours vs story points), set working hours/points per day, default tax, business days, and an optional default board.
  3. Team (optional) — pick a project and add team members. You can skip this and come back later.
  4. Review — confirm and finish.

When you complete onboarding, Ekko marks it as done in storage and lands you on the home dashboard. The next time you open the app it skips straight there.

3. The home dashboard

The home dashboard is a grid of feature cards. Each card is a doorway into one of Ekko's features.

Sprint Planning
The flagship view: pick a board and sprint, then plan in a task-centric layout with capacity, child tasks, and linked tasks all visible at once.
Team Management
Define who is on the project team, set per-person capacity and tax, and manage holidays.
Task Creator
Multi-issue creation flows: one task, parent + subtasks, fan-out across parents, mirror an existing issue, or start from a saved template.
Analytics & Reports
Coming soon — placeholder card on the dashboard today.
Settings
Theme, capacity mode, defaults, business days, default board, and re-run onboarding.
Support
Opens the Ekko Help Center in a new tab.

4. Moving around with the side navigation

Once you have left the home page, a thin icon rail appears on the left edge of the screen. Hover over it to expand to a labelled menu. Click any icon to jump straight to that feature — no need to bounce back to home.

The side nav is hidden on home and during onboarding because the dashboard already shows everything. It also stays hidden on the Sprint Poker voter surface so phone voters have a clean view.

5. Where to go next

  • Walk through the Onboarding guide for a screen-by-screen breakdown of every wizard step.
  • Open the Sprint Planning guide to learn the task legend, linked tasks, in-place editing, and the capacity summary.
  • Skim Tips and Tricks for shortcuts experienced users wish they had known on day one.