mirror of
https://github.com/twentyhq/twenty
synced 2026-04-21 21:47:38 +00:00
183d034716
Reorganizing by Feature sections
Capabilities folders to give an overview of each feature
How-Tos folders to give guidance for advanced customizations
Reorganized the Developers section as well, moving the API sub section
there
added some new visuals and videos to illustrate the How-Tos articles
checked the typos, the links and added a section at the end of the
doc.json file to redirect existing links to the new ones (SEO purpose +
continuity of the user experience)
What I have not updated is the "l" folder that, per my understanding,
contains the translation of the User Guide - that I only edited in
English
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> <sup>[Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) is
generating a summary for commit
5301502a32. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
---------
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Co-authored-by: github-actions <github-actions@twenty.com>
Co-authored-by: Abdul Rahman <ar5438376@gmail.com>
Co-authored-by: Félix Malfait <felix.malfait@gmail.com>
47 lines
1.4 KiB
Text
47 lines
1.4 KiB
Text
---
|
|
title: Supported File Formats
|
|
description: File formats supported for data import in Twenty.
|
|
---
|
|
|
|
## Supported Formats
|
|
|
|
Twenty supports three file formats for import:
|
|
|
|
| Format | Extension | Notes |
|
|
|--------|-----------|-------|
|
|
| **CSV** | .csv | Recommended, most compatible |
|
|
| **Excel** | .xlsx | Modern Excel format |
|
|
| **Excel (Legacy)** | .xls | Older Excel format |
|
|
|
|
## File Requirements
|
|
|
|
| Requirement | Value |
|
|
|-------------|-------|
|
|
| **Encoding** | UTF-8 recommended |
|
|
| **Record limit** | 10,000 records per file |
|
|
| **Structure** | First row must contain column headers |
|
|
| **Content** | One object type per file |
|
|
|
|
## CSV Best Practices
|
|
|
|
- **Delimiter**: Use comma (`,`) or semicolon (`;`)
|
|
- **Text qualifier**: Use double quotes (`"`) for text containing commas
|
|
- **Line endings**: Windows (CRLF) or Unix (LF) both supported
|
|
- **Empty values**: Leave cells empty, don't use "NULL" or "N/A"
|
|
|
|
## Excel Best Practices
|
|
|
|
When exporting from Excel:
|
|
- Remove formulas (export values only)
|
|
- Delete empty rows at the end
|
|
- Ensure no merged cells
|
|
- Use the first sheet only
|
|
|
|
## Large Datasets
|
|
|
|
For datasets larger than 10,000 records:
|
|
- Split into multiple files
|
|
- Or use the [API import](/user-guide/data-migration/how-tos/import-data-via-api) for unlimited records
|
|
|
|
<Note>For very large migrations (100,000+ records), the API is significantly faster and more reliable than CSV imports.</Note>
|
|
|