# Quick Start

Learn the basics and get your team up and runnung with Shortcut

Hello 👋! We’re so glad you’re here!

Start here and see why Shortcut is the project management tool your team will actually enjoy using. Let’s get into it!

## The Basics <a href="#h_01j8g5bqq0q45qc2sfqz3ynzwz" id="h_01j8g5bqq0q45qc2sfqz3ynzwz"></a>

Shortcut is designed for product development teams who care about making progress. It unites issue tracking, sprints, roadmaps and goals into a single experience to help teams - from startup to scale - build and ship products. Shortcut’s hierarchy is simple:

![Shortcut Hierarchy.png](/help/assets/Shortcut%20Hierarchy.png)

* **Stories** represent a shippable scope of customer value. They capture the problem that needs solving, and specify requirements and acceptance criteria. Stories often have multiple implementation steps that can be captured with Sub-tasks.&#x20;
* **Sub-tasks** capture the implementation steps of Stories. They move through your team's workflow and stay connected to GitHub.
* **Epics** are collections of Stories that represent larger projects. Epics are great for cross-functional squads to manage work. For example, the go-to-market plans for a feature launch might involve Stories from product, engineering, marketing and CX.
* **Objectives** connect teams, the projects they own, and individual work to strategic company goals. Objectives are made up of Epics and the associated Key Results let you see progress as work is completed.&#x20;

💡Look for the Breadcrumbs on Story and Epics detail pages to let you drill down into how those pieces of work connect back to the strategy, helping align teams focus with the work that matters most.

![](/help/assets/8e4b7eb8-465b-41b3-a28d-59389a63cc7e)

Read more about the Shortcut hierarchy and our product development philosophy in [The Shortcut Way](https://www.shortcut.com/shortcut-way).

## Getting Setup

Importing your data brings your progress, history and insights directly into Shortcut, so you can pick up right where you left off. We offer [importers](/help/admin/import-overview) to help you move from other project management tools quickly and effortlessly. _You can do this anytime - now or later!_

## Integrates with Tools

* [Connect Github, GitLab or Bitbucket](/help/getting-started/setup-vcs) and save your team time and manual work by linking Stories to commits, branches and pull requests to automatically move Stories across your workflow and keep things up to date with the work you’re already doing.
* [Slack](/help/integrations/slack) lets you create and update Stories directly from Slack and see the progress that your team is making inside of Slack.
* [See the full list of integrations](https://www.shortcut.com/integrations)

| 💡Use ⌘K (cmd/ctrl + k) to access [keyboard shortcuts](/help/getting-started/keyboard-commands) to fly around Shortcut with only your keyboard. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

## Managing Work

The best thing about Shortcut is that it can help you get stuff done faster and keeps all of your work organized so you and your team can see what’s happening, who’s doing it and when it will be done.&#x20;

## Start by creating a Story

[Add in a title, description, and connect related documents and tasks.](/help/stories/stories-overview) Once created, if you connected GitHub (or your preferred VCS), you can automatically link commits, pull and merge requests, and more, to your Story - saving you time and keeping things in sync.&#x20;

| 💡If your team uses Sprints, you can use the “[Iteration](/help/iterations/iterations-overview)” field to assign this Story to an upcoming Sprint. |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

When you’re done, click _Create_ and see your Story on the Kanban board. As progress is made on this story, it will move from left to right as it goes through each workflow state until it’s done.

## Add Stories to an Epic

[Epics](/help/epics/epics-overview) are collections of Stories and are meant to organize work for features or releases. As an example, if your team is working on an updated mobile UI for your application, all of the Stories that you created for this project will sit inside of an Epic. As Stories are completed, you’ll see progress made on the Epic until the feature is ready for delivery.

![](/help/assets/getting-started-epics-page.png)

Go to your Epic page and add the Story you just created to a new Epic. You can create additional Stories right on the page to group the related work together.

## Roadmap

[The Roadmap](/help/views/roadmap-overview) makes planning, visualizing and communicating work across your organization even easier. It’s organized by teams and structured via Epics, making it a flexible way for teams to clearly communicate what they’re going to build, and when, to keep the broader team aligned.&#x20;

Add your Epics to the Roadmap to explore the options: you can rearrange the order and customize what’s shown to keep your Roadmap view focused.

Add a Health Status with contextual comment to indicate if work is On Track, Off Track or At Risk. You can also export your Roadmap view to share it with your team.&#x20;

💡Even if an Epic is not assigned to the team, the Epic can still be added to the that group to help craft cross-collaborative team roadmaps.&#x20;

## Plan Sprints with Iterations

[Iterations](/help/iterations/iterations-overview) (similar to Sprints) are defined periods of time where we aim to deliver a set of Stories. At Shortcut, we work in two week iterations. Your Iteration page displays what Stories you’re working on during the Iteration and provides valuable, at-a-glance versions of your [Burndown and Cumulative Flow](/help/iterations/iterations-overview#insights-and-reports) reports so you can quickly understand how work is progressing, identify bottlenecks in the process, and understand if you’ll meet your commitments.

![](/help/assets/b0dd7431-251d-4634-8268-63510437fd26)

## Objective are the Big Picture

[Objectives](/help/objectives/objectives-overview) let you see progress towards your top-level strategic goals in the same place as where the product development work is happening. As Stories roll up into Epics, Epics roll up into Objectives and are the key components that drive the business forward. You can add Key Results to track the metrics that matter most.

![](/help/assets/getting-started-iterations.png)

## Invite your Team

Shortcut was made for teams, and it shines when it comes to collaboration, so [invite a few teammates](/help/admin/invite-users) to try it out with you!&#x20;

The best way to see the value of Shortcut is to build something _real_ together. Pick something your team’s working on and create an Epic, add a few Stories, put it on a Roadmap. See it move across workflows and be delivered to your happy customers! Yay, progress! 👏&#x20;

We’ll be ready to answer any questions your team has as they get started. [Contact our team](https://www.shortcut.com/contact) or check out the Help menu to ask questions, find keyboard shortcuts and access our demo workspace.

> 💡 **Now that your team is in Shortcut**, keep up with the latest activity: Check out the activity feed to see everything that’s happening across your org, including comments on your Stories or those that you follow, and mentions directed at you.

Want to chat with other Shortcut users? [Join the Shortcut Slack community](https://shortcut.com/joinslack)

Like what you see and are ready to get started? [Sign up for Shortcut](https://www.shortcut.com/signup)