Documentation v1.0
Docs Drafts Promote a draft to a sprint

Promote a draft to a sprint

When a draft is ready to become real work, click the Promote dropdown in the breadcrumb (top right of the show page) and pick the destination project. The draft moves to that project's backlog with all its fields intact: title, description, AC, priority, points, due date, tasks, comments.

From the backlog you can then assign it to a specific sprint and an Epic.

What changes on promotion

  • project_id flips from your personal project to the target project
  • column_id resets to the target project's default "To Do" column
  • Everything else (title, description, AC, priority, points, due date, tasks, activity) carries over
  • The story keeps its original ID and URL changes from /drafts/:id to the standard /projects/:slug/sprints/:id/stories/:id

Promotion is one-way

There's no "demote back to draft" action by design — once a story is in a project, treat it as committed work. If you change your mind, you can move it to the project backlog or delete it like any story.

Last updated July 18, 2026