Import from CSV

Importing from CSV is a universal way to transfer tasks, projects, and entire structures into SingularityApp from almost any other app or spreadsheet. The key is to prepare the file correctly.

This feature is available in the desktop versions of the app (Windows, macOS, Linux).

Step 1. Preparing the CSV File

You need to create a table that can contain up to eight columns. The most important one is Name. If you fill in only this column, each row will be imported as a separate task. If you fill in the other columns as well, you can recreate in SingularityApp a complex structure of projects, sections, and tasks with dates, priorities, and descriptions.

Column Descriptions

  • Id
    • Purpose: defines the hierarchy (nesting level) for your projects and tasks.
    • How to fill in: use numbering like 1, 1.1, 1.1.1. For example:
      • 1 — top-level project
      • 1.1 — nested project, section, or task inside project 1
      • 1.1.1 — task nested inside task 1.1
    • Nesting rules: a project can contain other projects, sections, and tasks. A section can only contain tasks. A task can only contain other tasks (subtasks).
    • If left empty: all rows will be imported as a flat list.
  • Type
    • Purpose: defines whether the row is a project, section, or task.
    • How to fill in: use one of the following values:
      • project — for a project
      • section — for a section
      • task — for a task
    • If left empty: all rows will be imported as tasks.
  • Name (Required Column)
    • Purpose: this is the name of your project, section, or task.
  • Description
    • Purpose: allows you to add a detailed description or notes for a project or task (sections don’t have descriptions). Links are supported.
  • Priority
    • Purpose: sets the task priority.
    • How to fill in:
      • 0 — pin the task at the top (highest priority)
      • 1 — high priority (task name appears in bold)
      • 3 — low priority (task name appears dimmed)
  • Status
    • Purpose: allows you to import tasks with a specific status.
    • How to fill in:
      • x — canceled task
      • — — completed task
      • . — task in progress (it will appear in „Today“ every day until completed)
  • Date
    • Purpose: sets the start date for the task.
    • How to fill in: use the format YYYY-MM-DD. You can also specify the time, for example: 2025-12-31 18:30.
  • Deadline
    • Purpose: sets the due date (deadline) for the task.
    • How to fill in: use the format YYYY-MM-DD.

Example File and Saving

You can download an example file to better understand the structure: SingularityApp-CSV-example.csv

When saving the file, make sure that:

  1. File format is CSV.
  2. Encoding is UTF-8.
  3. Column separators are commas.

If you’re using Google Sheets, simply select FileDownloadComma-separated values (CSV). The file will automatically be saved in the correct format.

Step 2. Importing the File into SingularityApp

  1. In the top system menu of SingularityApp, select FileImportImport from CSV.
  2. Select your prepared CSV file in the dialog window that opens.
  3. Wait for the import process to complete.
The documentation is automatically generated. If you haven’t found the answer to your question, please contact us at support..
Android
Android
Windows x64
Windows x64
Install it on all your devices so your to-do list is always at hand