Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.maestra.io/llms.txt

Use this file to discover all available pages before exploring further.

To upload data into Maestra Platform, your file needs the right format and encoding. This guide walks through the requirements and shows how to save the file correctly from common spreadsheet apps.

​
File requirements

ParameterValue
Format.csv or .txt
EncodingUTF-8, UTF-8 with BOM, or Windows-1251
DelimiterAny (commonly comma , or semicolon ;)
Text qualifierAny (double quotes " recommended)
SizeUp to 1.5 GB
File nameUp to 400 characters; cannot contain \ / : * ? " < >

​
File format

Maestra accepts two formats:
  • .csv (recommended)
  • .txt
Other spreadsheet formats ( e.g.,.xlsx, .xls, .ods) are not supported.
How to check the format: look at the file extension after the dot — customers.csv works, customers.xlsx does not.
Import File Recommendations Type
Don’t see file extensions?
  • Windows: in File Explorer, go to View and enable File name extensions.
  • macOS: in Finder, go to Settings → Advanced and enable Show all filename extensions.
Or check the file type in its properties (right-click → Properties on Windows, or right-click → Get Info / Cmd + I on macOS).

​
Encoding

Encoding tells your computer how to interpret letters and symbols. If the file’s encoding doesn’t match what Maestra Platform expects, names may appear as garbled characters like Ðнна Иванова in the preview. Fix: re-save the file as UTF-8 using the instructions in How to save the file correctly.

​
Column delimiter

In .csv and .txt files, data is stored as plain text and columns are separated by a delimiter character. Maestra Platform supports any delimiter. The most common ones are:
DelimiterWhat it looks like
Comma ,(recommended)Smith,John,+15551234567
Semicolon ;Smith;John;+15551234567
Tab \tSmith John +15551234567
How to check the delimiter:
  1. Open the file in Notepad (Windows) or TextEdit (macOS).
  2. Look at the first data row.
  3. Note the character separating the values.
Phot
If the import preview shows all your data crammed into a single column, just pick the correct delimiter in the upload settings — the columns will redistribute automatically.

​
Text qualifier

A qualifier is a character that wraps values containing special symbols (like a comma inside an address, or a line break). Without it, those values would be misread as multiple columns.
The recommended qualifier is double quotes ".
Example: Without a qualifier: 
Name,Address,Phone
John,Boston, MA, 5 Main St,+15551234567
The delimiter ; also appears inside the address. Maestra Platform would see 4 columns instead of 3 and throw an error. With a qualifier: 
Name,Address,Phone
John,"Boston, MA, 5 Main St",+15551234567
How to check the qualifier:
  1. Open the file in Notepad or TextEdit.
  2. Look at rows where values contain punctuation (addresses, product descriptions, reviews).
  3. If those values are wrapped in "...", the qualifier is ". If not, no qualifier is in use.

​
File size

The limit is 1.5 GB per file, which is plenty for almost any task. How to check file size:
  • Windows: right-click the file → Properties → Size.
  • macOS: right-click → Get Info / Cmd + I.
What to do if your file is larger than 1.5 GB:
  1. Split the file into parts (by region, segment, date range, etc.) and upload each part as a separate import.
  2. Remove duplicate columns and rows.
Smaller files (under 200–500 MB) upload and process faster. For recurring imports, break large exports into smaller chunks.

​
How to save the file correctly

Pick the tool you use.
1

Open or prepare your file

2

Choose File → Save As

3

Pick a folder

4

Enter a file name

5

In the file type dropdown, choose one of

  • CSV (comma delimited) — recommended
  • CSV UTF-8 (comma delimited)
  • Text (tab-delimited)
Screenshot 2026 05 21 121122
6

Click Save

1

Open or prepare your file

2

Choose File → Save As

3

Pick a folder and file name

4

In the file type dropdown, choose Text CSV (.csv)

5

Enable Edit filter settings to set encoding, delimiter, or qualifier

6

Click Save

7

In the dialog that appears, set

  • Character set: UTF-8
  • Field delimiter: ,(comma)
  • String delimiter: " (double quote)
8

Click OK

Google Sheets always exports .csv as UTF-8 with a comma delimiter. There’s no way to change the delimiter or qualifier from the UI.
1

Open the file in Google Sheets

2

Choose File → Download → Comma-separated values (.csv)

Screenshot 2

​
Common problems

​
Non-Latin characters appear as ”?” or gibberish

The file is saved in an unsupported encoding. Re-save it as UTF-8 (or Windows-1251) using the instructions above.

​
Data lands in a single column on upload

Maestra Platform couldn’t detect the delimiter. In the upload settings, manually pick the delimiter (and qualifier if needed) — the preview will redistribute columns automatically. If that doesn’t help, re-save the file with a different delimiter.

​
The file is rejected on upload

  • Check the extension — only .csv and .txt are supported.
  • Check the file name — it cannot contain forbidden characters.
  • Check the size — it must be under 1.5 GB.