Data Import (CSV, JSON, GEDCOM)

TimeWrit supports importing data from various formats, allowing you to bring in research from other tools or use AI to extract events from raw text. ## Supported Formats You can import data into TimeWrit using the following formats: - **CSV (Comma Separated Values)**: The primary format for bulk-importing Events, People, or Locations. - **JSON (Historical Timeline)**: A full-fidelity format used for migrating data between TimeWrit projects. - **GEDCOM (.ged)**: The industry standard for genealogical data, allowing you to import family trees and individual records. > [!IMPORTANT] > **Data Ownership**: All imported records are assigned to you and tagged with "Imported via [Format]" to help you track their provenance. ## Importing CSV and JSON Data The primary import interface is located in the site administration under **Import Data**.  ### Field Breakdown (CSV Events) When importing events via CSV, the following columns are supported: - **title**: A short, descriptive name for the event. - **description**: Detailed markdown-enabled text. - **start_date**: ISO 8601 format (`YYYY-MM-DD`). - **end_date**: Optional. Defines a duration. - **location**: Name of the location. TimeWrit will automatically link to existing locations or create new ones. - **people**: Comma-separated list of individuals involved. - **timelines**: Comma-separated list of target timelines. ## AI Data Extraction If you have raw notes or a PDF document, you can use an AI (like Claude or ChatGPT) to generate a compatible CSV for you. 1. Navigate to the **Import Data** page. 2. Click the **Get AI Prompt** button. 3. Select your import type (Events, People, or Locations). 4. Copy the prompt and paste it into your AI of choice along with your data.  > [!TIP] > Always review the CSV output from an AI before importing to ensure date formats and column headers are exact. ## GEDCOM Import For genealogical researchers, the GEDCOM importer allows for deep family tree integration.  1. Navigate to **Timeline > GEDCOM Import** in the admin. 2. Select an optional **Target Timeline**. If selected, all birth and death events from the GEDCOM will be added to this timeline. 3. Upload your `.ged` file. TimeWrit recognizes GEDCOM 5.5.1 standards, including recursive family relationships (Spouse, Parent, Child) and source citations.