Documentation

Exporting Data

Export your database records to CSV or JSON for external analysis, backup, or sharing.

Overview

Simpl allows you to export data from any table, with your current filters and sort order applied.

Export panel

Opening Export

Click the Export button in the toolbar to open the export panel.

Export button in toolbar

Export Formats

CSV Export

Comma-separated values, ideal for:

  • Spreadsheet analysis (Excel, Google Sheets)
  • Data import into other systems
  • Simple data sharing

CSV export option

JSON Export

JavaScript Object Notation, ideal for:

  • Developer workflows
  • API consumption
  • Preserving complex data types (arrays, nested objects)

JSON export option

What Gets Exported

Current View

The export includes:

  • Records matching your current filters
  • Sorted in your current order
  • Columns based on your layout settings

All Matching Records

Unlike the paginated list view, exports include all matching records, not just the visible page.

Column Selection

Exported columns follow your layout configuration:

  • Visible columns are included
  • Hidden columns are excluded
  • Column order matches your layout

Performing an Export

Step 1: Set Up Your View

Before exporting:

  1. Apply any needed filters
  2. Set your desired sort order
  3. Configure column visibility in layout

Step 2: Open Export Panel

Click the Export button in the toolbar.

Step 3: Choose Format

Select CSV or JSON based on your needs.

Step 4: Download

Click Export to download the file. The file downloads to your default download location.

Download confirmation

File Naming

Export files are named automatically:

{table_name}_{timestamp}.{format}

Examples:

  • users_2024-01-15_143022.csv
  • orders_2024-01-15_143022.json

CSV Format Details

Structure

column1,column2,column3
value1,value2,value3
value1,value2,value3

Special Characters

  • Values with commas are quoted
  • Quotes are escaped as double-quotes
  • Newlines are preserved within quotes

Data Types

Database TypeCSV Output
TextAs-is
NumbersNumeric string
Booleans"true" or "false"
DatesISO 8601 format
JSONJSON string
ArraysJSON array string
NullEmpty cell

JSON Format Details

Structure

[
  {
    "column1": "value1",
    "column2": 123,
    "column3": true
  },
  {
    "column1": "value2",
    "column2": 456,
    "column3": false
  }
]

Data Types

Database TypeJSON Output
TextString
NumbersNumber
BooleansBoolean
DatesISO 8601 string
JSONNested object/array
ArraysArray
Nullnull

Export Limits

Row Limits

For performance, exports have maximum limits:

  • Large exports are paginated server-side
  • Very large tables may be truncated
  • Check row count after export

Timeout

Export queries have the same timeout as regular queries (10 seconds). For very large exports:

  • Apply filters to reduce dataset size
  • Export in smaller batches
  • Consider direct database export for massive datasets

Use Cases

Analysis in Spreadsheets

  1. Filter to relevant data
  2. Export as CSV
  3. Open in Excel or Google Sheets
  4. Create charts, pivot tables, etc.

Backup Selected Data

  1. Filter to critical records
  2. Export as JSON (preserves types)
  3. Store the export file safely

Sharing with Stakeholders

  1. Set up view with relevant columns
  2. Apply appropriate filters
  3. Export as CSV
  4. Share the file

Developer Workflows

  1. Export as JSON
  2. Use in scripts or tests
  3. Import into development databases

Tips

Filter First

Always filter your data before exporting:

  • Reduces file size
  • Faster download
  • More focused data

Check Column Visibility

Before export, review your layout:

  • Only visible columns are exported
  • Reorder columns for desired output
  • Temporarily show columns if needed

Large Datasets

For tables with millions of rows:

  • Apply strict filters
  • Consider exporting in date ranges
  • Use direct database tools for full dumps

Current Limitations

  • No scheduled exports - Exports are manual, on-demand
  • No email delivery - Files download directly to browser
  • Single table - Export one table at a time
  • No Excel format - Use CSV and open in Excel

Next Steps