Skip to main content
You may choose to use File Upload if:
  • You need to import data quickly without setting up a full integration.
  • You have CSV files from systems that don’t have direct integrations.
  • You want to test data in Runway before committing to a full integration setup.
  • You have one-time data imports that don’t require ongoing syncing.

​
File requirements

Before uploading your CSV file, ensure it meets these requirements:
  • File format: Only .csv files are supported.
  • File size: Maximum file size is 50MB.
  • Data structure: The first row should contain column headers.
  • Data quality: Ensure at least one data row exists below the headers.
  • Date format: Use MM/DD/YYYY format for date columns (e.g., 01/15/2024).
For best results, clean your CSV file before uploading—remove extra blank rows, ensure consistent column headers, and format dates as MM/DD/YYYY (e.g., 01/15/2024).

​
Connecting the File Upload integration

  1. Open Runway and navigate to Integrations.
  2. Find and install the File Upload integration listed under the Data storage section.
  3. A new query called New File Upload will be automatically created.
  4. You can rename this query by clicking the three-dots button next to the query name in the sidebar and selecting Rename query.

​
Uploading a CSV file

Once you’ve connected the File Upload integration:
  1. Click on your File Upload query in the sidebar.
  2. In the query editor, you’ll see a file upload interface.
  3. Click Choose File and select your CSV file (must be .csv format and under 50MB).
  4. The file will upload automatically. You’ll see a confirmation message when the upload is complete.
  5. Click Run query to import the data into Runway.
File uploads must be run manually. Unlike other integrations, File Upload queries cannot be scheduled to sync automatically.

​
Refreshing data

To update the data in your File Upload query:
  1. Upload a new CSV file using the same steps above.
  2. Click Run query to refresh the data.
  3. The new data will replace the previous data in your linked database.
Each time you upload a new file and run the query, it completely replaces the previous data. Make sure your new file contains all the data you need.

​
Using uploaded data in databases

After running your File Upload query:
  1. Configure a new database linked to your File Upload query.
  2. The database will display the data from your CSV file.
  3. You can now use this data in your models, pages, and formulas just like any other integration.

​
File upload FAQs

No. File Upload queries must be run manually. If you need automatic syncing, consider using Google Sheets or a data warehouse integration instead.
Files larger than 50MB cannot be uploaded. You’ll need to either:
  • Split your file into smaller CSV files and create multiple File Upload queries.
  • Aggregate your data before exporting to reduce the file size.
  • Use a data warehouse integration for larger datasets.
No. Each File Upload query can only contain data from one CSV file at a time. When you upload a new file and run the query, it replaces the previous data. If you need to import multiple CSV files, create separate File Upload queries for each file.
Runway supports standard CSV files with:
  • Comma-separated values (, as delimiter)
  • Column headers in the first row
  • At least one data row below the headers
  • Date columns formatted as MM/DD/YYYY (e.g., 01/15/2024)
The CSV parser is flexible and handles quoted fields and leading/trailing spaces automatically.
If you don’t see data after uploading and running the query, check:
  • Your CSV file has column headers in the first row.
  • There is at least one data row below the headers.
  • The file is properly formatted as a CSV (not Excel or other formats).
  • You clicked Run query after uploading the file.
No. File Upload queries are read-only. To modify the data, you need to:
  1. Edit your CSV file outside of Runway.
  2. Upload the updated CSV file.
  3. Click Run query to refresh the data.