Duplicate a project

You can use Tracker’s CSV import/export feature to duplicate a project. Just export its stories and epics so they can be imported into a new project, or used as a template for importing into a project at a later time.

1. Export all stories/epics from the project you wish to duplicate

To duplicate a project, start by exporting all its stories and epics.

  1. Click the Settings tab in the top nav of your Project Stories view.
  2. Choose Export CSV from the side navigation menu.
  3. All stories will be exported by default; however, make sure to select All Epics if you’d like those exported as well.
  4. You can also select subsets of stories, including Done, Current/Backlog, or Icebox stories.
  5. Click Export.

2. Groom your CSV file

After your file has been exported, you’ll want to go through it to ensure it imports into the new project smoothly.

  1. Open your CSV file in a spreadsheet application such as Excel or LibreOffice.
  2. You can only import 3000 stories at a time into Tracker, so you’ll want to break up the file if it has more than 3000 stories in it. Please be sure to include the header row in each additional CSV file for import (i.e., ID,Title,Labels,Type,Estimate,Current State,Created at,Accepted at, etc).
  3. Remove the ID column from each file (story IDs are unique and would only be retained if you are updating existing stories via CSV import).
  4. If the originating project had any externally linked integrations (e.g., Zendesk, Bugzilla, etc.), please make sure they are also identically configured in the destination project. Otherwise, you’ll need to remove the Integration columns from each file.
  5. Make sure your files are saved in UTF-8 as well as CSV format.

You can now either save your file as a “template” to be imported into a new project at a later time, or proceed to Steps 3 and 4 to complete the process.

3. Create a new project

If you haven’t already, create a project in Pivotal Tracker, then check its Project Settings page to make sure the point scale is the same as you’ve been using to estimate within the original project. Then, invite your team members to that project so they’ll be able to use the stories you’re about to import.

Additional considerations

  • As long as you invite the original project members to the new project prior to importing, all original story requesters will be retained. Otherwise, the importer will become the requester of any stories in which Tracker is unable to map to an existing project member.
  • Email notifications are not generated from the import process.
  • If you estimated bugs/chores in the originating project, you’ll need to enable the Bugs and Chores May Be Given Points setting from your Project Settings page; otherwise you’ll receive an error when importing a file that contains pointed bugs/chores.
  • If the originating project had any externally linked integrations (e.g., Zendesk, Bugzilla, etc.), please make sure they are also identically configured in the destination project. Additionally, the integration name(s) in your file needs to match the integration name(s) in the project.

4. Import your CSV file into your new project

Now that you’ve groomed your CSV file and created the destination project, you can import your file into the new project by following these steps:

  1. After loading the destination project in Tracker, click Settings in the top nav of your Project Stories view.
  2. Select Import CSV from the sidebar.
  3. Click Choose File and select the appropriate file.
  4. Repeat Steps 1-3 for any additional files.

For more on importing, see CSV import/export.

If for any reason you encounter errors while importing and are unable to resolve them yourself, feel free to email our support team at tracker@pivotal.io (preferably with a copy of the problematic CSV file).

Previous
Working across multiple projects
Next
Getting RSS feeds