Files
Upload
You can upload new documents by clicking the Upload button and selecting files from your local system.
File limits
Maximum file size: 200 MB
Maximum text length per record or TXT file: 2000000 characters
File Preparation Guidelines
To ensure successful upload and processing, please follow these requirements when preparing your files:
1. Remove all non-table content
Delete any titles, notes, comments, customer info, footers and empty rows.
The file must start with a single header row.
Each column must have only one header cell (no merged header fields).
Do not include multiple tables in one file.
2. Ensure a clean table structure
One row = one item/record.
No merged cells anywhere.
No separate tables side by side or below each other.
All rows must follow the same structure (same number of columns).
3. Use plain text only
Remove all images, icons, emojis, bullets, shapes, hyperlinks or embedded objects.
If an image was originally present, delete it or replace it with text (e.g., link or “no image”).
4. Add and maintain a unique ID column
The file must contain one column with unique values.
This column will be used as the system ID.
5. Clean and normalize content
Convert multi-line content into a single line.
Example:
I worked at X • Task 1 • Task 2
I worked at X: Task 1, Task 2.
No bullet lists or paragraph formatting.
Remove unnecessary whitespace and formatting characters.
Replace decorative symbols with plain text equivalents:
✓ → OK
• → "," or "-"
“ ” → " (standard quotes)
6. Validate numeric fields
Avoid scientific notation (e.g., change
1E+08→100000000).
7. Use correct CSV formatting
Separator: semicolon (;)
Encoding: UTF-8
No blank columns
8. Missing data
If a value is missing, you can leave the cell blank.
9. Avoid Excel auto-formatting issues
Excel may:
Convert long numbers to scientific notation
Remove leading zeros
Interpret values as dates
To prevent this:
Set ID columns to Text format before entering data
Disable automatic formatting when possible
After exporting to CSV, open the file in a text editor to verify correctness
Supported file formats
Direct upload: TXT, CSV
Other formats: BMP, DOC, DOCX, EML, EPUB, HEIC, HTML, JPEG, PNG, MD, MSG, ODT, ORG, P7S, PDF, PNG, PPT, PPTX, RST, RTF, TIFF, TSV, XLS, XLSX, XML
For unsupported formats, convert them to TXT or CSV using document processing tools before uploading.
Automatic file conversion
Smabbler Portal is integrated with Unstructured IO for automatic document processing. If you upload a file that is not in TXT or CSV format, a pop-up window will appear where you can enter your Unstructured IO API key and URL. The system will then convert your file via API before processing.
We do not store any API credentials or converted files.
Analyze
After uploading, select the file(s) you want to analyze and click on the Analyze button. For the CSV file, a configuration window will appear with two steps:
Step 1: Select ID column
Choose the column that contains unique record identifiers.
The selected column must contain unique values.
This column will be used as the system ID.
Only one ID column can be selected.
Step 2: Select text columns
Choose one or more columns that contain the text you want to analyze.
You can select multiple text columns.
You can use Select all columns to quickly include all available text columns.
The total text content per record must not exceed 2,000,000 characters.
Analyze column names
When enabled, the column headers will be analyzed in addition to the row content.
This option is especially useful for files with many columns and rows, where column names provide important context.
For example:
Column 1 – Client name
Column 2 – Client address
Column 3 – Client phone number
Including column names helps the system better understand the structure and meaning of the data.
Starting the analysis
After selecting the ID column and text column(s), click Analyze to begin processing.
Once the analysis is complete, the file status will update in the file list (e.g., Uploaded → Analyzed).
Build graph model
Once your files are analyzed, you can build your graph model.
Choose one or more analyzed files.
Click Build graph model to proceed.
Enter a model name in the dialog box and click Create.
Your model is now ready for activation in the Models tab.
File statuses
Each file has a Status column to indicate processing progress:
Uploaded - the file is added but not analyzed yet.
Analyzed - the file has been processed and is ready to be used in graph model creation.
File(s) actions
Each file entry provides the following actions through on-screen icons:
View Details - click the info icon in the file row to view metadata such as file name, creation and analysis dates, size and a preview of its content as well as the analysis efficiency rate.
Add Tags - click the plus icon in the Tags column to assign new tags to a file that currently has none.
Edit Tags - if a file already has tags, click the pencil icon next to the tag(s) to modify or remove them. Tags will help you organize and filter files efficiently.
Select all - selects all files in the Files table.
Select visible - selects only the files currently visible on the page.
Clear selection - deselects any selected files.
Remove selected - deletes all currently selected files.
Last updated