Hosted Parodies

Import & export

Every hosted Parody can import records from CSV files and export everything it holds, as CSV for spreadsheets and other tools or as one JSON backup.

Open a Parody and choose Import & export in its menu. Moving from a specific tool? Each product has a step-by-step guide, such as Move from Jira.

Export#

  • Download everything (JSON) is the complete backup: every record of every type, with IDs and timestamps.
  • CSV, one file per record type, opens in any spreadsheet and is what other tools import.

Your data is always yours

Exports work even when a Parody is paused after the free month or a canceled subscription. The paused screen has a Download everything link.

CSV columns

ColumnHolds
idThe record's ID in the Parody.
due_dateOne column per field, named as in the record type's field list.
project_id (name)After each link, the linked record's name. Other tools can't read Parody IDs, so use these for links.
source_idOnly for records imported with an ID from another tool: that original ID, such as a Jira key.
created_atWhen the record was created, in UTC.
updated_atWhen it last changed, in UTC.

Lists, such as a pipeline's stages, are written with ; between items. Files are UTF-8 with a byte-order mark, so Excel shows accented names correctly.

JSON backup

The JSON file has a format of featureparity.parody-export and a version, the Parody's name, product, and features, and an objects map from record type to its records, each with id, created_at, updated_at, and data.

Import#

  1. Under Import, choose the record type to import into, then the CSV file.
  2. Check the column list. Each column shows its first value and the field it goes into. Change any that are wrong, or choose Don't import.
  3. Select Import.

Every row is checked before anything is written. If any row has a problem, nothing is imported and you see each problem by line number (the header is line 1). Fix the file and import again, or tick Skip rows with problems and import the rest.

How columns are matched

A column is matched to a field when its heading is the field's name or label (due_date or Due date), a common name for it in other tools' exports (Notes for description, Deal Stage for stage), or, for links, the linked record type (Project, AccountId). Upper and lower case, spaces, and punctuation don't matter.

How values are read#

Field typeAcceptedEmpty cell
TextAnything, up to 2,000 characters.Empty text
Long text (descriptions, notes, bodies)Up to 10,000 characters, line breaks included.Empty text
Number1200, 1,200.50, $1,200, 45%, (300) for −300.Blank
Yes/notrue, false, yes, no, y, n, 1, 0, x, checked, done.No
Date2026-11-21, month-first 11/21/2026 or 11/21/26, Jira's 21/Nov/26, and Nov 21, 2026. A time after the date is ignored.Blank
Date and timeISO 8601 with a time zone, or any date above with an optional time like 2:30 PM, read as UTC.Blank
PersonAny name or email, up to 120 characters. New names are added to the people you can pick.Nobody
EmailAn address with an @.Empty
ListItems separated by semicolons, or by commas if there are no semicolons. Several columns mapped to one list are combined.Empty list
LinkSee Links, below.No link

Day-first dates

Dates like 21/11/2026 aren't read, because 03/04/2026 could mean March or April. Change the column's format to YYYY-MM-DD in your spreadsheet first.

A link column, such as the project on a task, can hold any of these, tried in this order:

  1. The linked record's Parody ID.
  2. For links within the same file, such as a subtask's parent: the parent row's ID column value.
  3. An ID from another tool that you mapped to ID when importing the linked record, such as a Jira key or a Salesforce Id.
  4. The linked record's name, ignoring case.

When a name matches several records, the importer picks the one under the same parent as the row: a task's section “To do” is the one in that task's project. If that still leaves more than one, the row is reported so you can use an ID instead.

Because links look for records that already exist, import parents first: projects before tasks, accounts before contacts. The Import & export page lists the order for your Parody.

Updating records#

Map a column to ID, and a row updates a record instead of adding one when that column holds:

  • a Parody record ID, such as from your own CSV export, or
  • an ID from another tool that the record was imported with.

Only mapped columns change; other fields keep their values. A mapped column with an empty cell clears that field. That's how a final export from your old tool, imported on switch-over day, updates what changed without duplicating anything.

Start empty#

New Parodies come with sample records. Before importing real data, use Delete all records at the bottom of the Import & export page. It removes every record in that Parody and can't be undone, so download a backup first if you've added anything.

Switching on a feature later adds sample records for any record type that is still empty. Delete those from the record's page if you don't want them.

Limits#

  • Up to 5,000 rows and 4 MB per file. Split bigger files and import them one after another.
  • CSV files only. Save spreadsheets as CSV (UTF-8) first. The first row must be the column headings.
  • Attachments and files can't be imported.

Guides by product#