We know your data needs to move with you, from Clubhouse and into Clubhouse, to keep up with the speed of success within your team. To help, we've created several ways that you can both import and export data from and to Clubhouse.
Importing Data
Are you looking to bring data into Clubhouse? We have several options to make the process as painless as possible to your team - you can use our importers for either Jira or Trello, or even utilize our API v3 to add data directly into your Clubhouse instance.
Ready to begin? Read our Trello Import installation guide, or expand to watch our Getting Started video below!
Check out our API documentation here for creating Stories, Epics, Milestones, Projects, Groups and more, as well as other helpful functionality.
Exporting Data
Clubhouse works best when it integrates into the tools your team uses the most. For teams looking to build out powerful custom reporting, automated workflows, or create backups of their data, we offer the convenience of exporting your data in either CSV or JSON in many places around Clubhouse.
Look for the "Export as CSV" prompt to export all of the Stories from a single Workspace, Iteration, Epic, Label, or Project.
For even finer control, you can even export a Space from the Stories page.
Quick Tip:
Export your entire Workspace from the Organization & Workspace Management Dashboard by selecting Export all Stories as CSV.
All exports include the following information about each Story:
| Column | Description |
|---|---|
| id | Story ID |
| name | Story Name |
| type | Story Type |
| requester | Story Requester |
| owners | A list of Story Owners if assigned |
| description | Story Description |
| is_completed | True if the Story is in a Completed state |
| created_at | The date and time the Story was created |
| started_at | The date and time the Story was moved to a Started state |
| updated_at | The date and time of the last update to the Story |
| moved_at | The date and time that the Story last changed states |
| completed_at | The date and time the Story was moved to a Completed state |
| estimate | Estimate points for the Story, if assigned |
| external_ticket_count | Number of attached external tickets |
| external_tickets | The URLs of the attached external tickets |
| is_blocked | True if the Story is blocked by another Story |
| is_a_blocker | True if the Story blocks another Story |
| due_date | The due date of the Story |
| labels | List of Labels applied to the Story. *Note* These are only Story Labels. Epic Labels will not be displayed in this list. |
| tasks |
List of Tasks in a Story. Completion is marked with an X and the task owner (if assigned) is included. |
| state | Workflow state of the Story when the download was initiated |
| epic_id | ID of Epic the Story is in (if any) |
| epic | Epic Name |
| epic_label | Epic labels linked to the story |
| project_id | ID of the Project the Story is in |
| project | Project Name |
| iteration_id | ID of the Iteration that the Story belongs to , if it belongs to one |
| iteration | Name of the Iteration that the Story belongs to, if it belongs to one |
| utc_offset | The user's UTC offset which affects the times displayed (this is different than the Organization UTC offset) |
You can use the Clubhouse Exporter to export all of your Clubhouse organization data to JSON files, which you can use to transfer your data to another system, maintain backups, or simply for data analysis.
- Download and install cURL (if you don't have it already).
- Navigate to Settings > My Account > API Tokens in Clubhouse and generate an environment-specific token.
- Download the Clubhouse Exporter shell script here. Be sure to use the correct script for your operating system.
- In your command line interface, set your API token as an environment variable.
- Run the Exporter script in your command line interface.
Please note the exporter does not include full entities for Story descriptions, comments, branches, commits, files, linked-files, and Tasks. To obtain these full entities, including Story descriptions, use our API's Get Story endpoint in subsequent requests.