DocsStart

Start a project from a file

Turn a backlog in Word, Excel, CSV or PDF into a project with its tickets and sprints, and review it before it is created.

Updated 22 November 2026

Upload a backlog as a Word, Excel, CSV or PDF file and Octopora sets up the project: its tickets, sprints and assignees. You review everything before anything is created.

Where to start

  • On the Projects page, click From a file to make a new project.
  • On a new account, the welcome questions offer Import a backlog.
  • Give the file to Helpi and choose Make it a project, or ask Helpi to make a project from it.
  • To add to an existing project, use Import backlog on the board or the Sprints page.

Files that work

AcceptedRefused
Word (.docx), Excel (.xlsx), CSV, TSV, textOld .doc and .xls files, .xlsb workbooks
PDF with selectable text, up to 60 pagesScanned PDFs without text, files with macros or a password
Up to 5 MB, up to 500 rows per importAnything larger

The file can be in any language. Hidden sheets, rows and columns, and pictures are skipped, and a notice says so.

The steps

  1. Upload: drop the file, choose Scrum (with sprints) or Kanban, a kickoff date and a sprint length of 1, 2 or 3 weeks, then Analyze backlog.
  2. Columns: pick the table and its header row, and say what each column holds: title, description, epic, priority, estimate, status, assignee, sprint, acceptance criteria, dependencies. Headers in English and French, and common tracker exports, are recognized.
  3. Review: every row shows Ready, Warning or Blocked. Send each to a sprint, the board or the backlog, or leave it out. Edit titles and descriptions, or let Helpi rewrite them.
  4. People: names in the file are matched to people by email or name. Leave someone unassigned or invite them to the project.
  5. Fields: for a project with a custom ticket form, give each field a column or one value for every ticket.
  6. Project: for a new project, its name, key, description and color.
  7. Apply: a final summary, then Create project or Apply import. It is all or nothing: if anything fails, nothing is created.

What it creates

  • Tickets with their title, description, state, priority, assignee and sprint, and their dependencies as blockers.
  • Sprints, back to back on working days from the kickoff date (Scrum only).
  • Invitations for the people you chose to invite.
  • For a new project, the project itself with its default roles, states and priorities.

Importing again into the same project shows which rows are new, changed or unchanged.

Plans

A new project counts toward your plan's projects (Starter allows 2), and invitations toward its members. Attaching the file to Helpi uses one of Helpi's file reads. An import stays open for a day; after that, upload the file again.

Questions

My PDF is refused.

Only PDFs with selectable text work. Export the file from its editor as PDF, Word or Excel.

Some people have no Octopora account.

They stay unassigned. Choose Invite to the project in the People step to bring them in.

Rewrites came out in another language.

Helpi writes in the language of your Octopora interface. Edit the rows to keep your file's wording.

Watch the tourProjects in a minute.