Import CSV files as a datasource
CSV files are the most efficient way to import existing data into Abyssale and generate hundreds of design variations in seconds.
Before you start
To ensure a smooth import, please verify that your file respects these technical requirements:
|
Step 1: Downloading your custom Sample CSV
Every Abyssale design is unique, and so is your data structure. To save time and avoid mapping errors, we recommend using our auto-generated CSV template.
Click on Create new spreadsheet from the Spreadsheet Generation tab.
Select Import CSV.
In the import modal, click the Download a sample CSV button.
IMPORTANT: Each sample CSV is unique to its design. Because the columns are generated based on your specific layers, a sample CSV downloaded for "Design A" will not work correctly for "Design B".
Step 2: Structuring your data
Once you open your CSV, here is how the data is organized:
|
Pro Tip: If you keep the column names exactly as they appear in the sample (matching your design's layer names), Abyssale will automatically match them during import, skipping the manual mapping step!
Step 3: Importing and Mapping
Drag and drop your completed CSV file into the modal or import via URL.
A mapping screen will appear. Here, you can match your CSV columns with the corresponding layer properties in your design.
Enable only the layers you wish to vary.
Click Import CSV. You will be redirected to your new Abyssale Spreadsheet.
Accepted Content Types
To ensure your data is recognized correctly, please format your cells as follows:
Data Type | Accepted Format | Example |
Color | Hexadecimal code (6 or 8 digits) |
|
Image | Direct URL to image (jpeg, png, svg) |
|
Video | Direct URL to video (mp4, webm) |
|
Text | Plain text. Use |
|
Rating | Number between 0 and 100. |
|
Column Naming Convention
If you prefer to create your own CSV from scratch rather than downloading our custom sample CSV, you can still benefit from automatic mapping. When our system detects that a column header in your CSV matches a layer name and property in your design, it will pair them automatically, skipping the manual configuration step.
Based on the structure of a standard Abyssale design, here are the exact column names you should use to trigger automatic matching:
Layer Type | Required Column Header Format | Column name Example |
Format Background Color |
|
|
Text Content |
|
|
Text Color |
|
|
Images |
|
|
Videos |
|
|
Buttons |
|
|
Ratings |
|
|
Shapes |
|
|
QR Codes |
|
|
Key Rules for Manual CSV Creation
Layer Names: The first part of the header (before the hyphen) must match the Layer Name defined in your Abyssale editor (e.g., if you renamed a text layer to "Headline", your column should be
Headline-payload).Properties: The second part (after the hyphen) must be the specific property you wish to change, such as
color,background_color, orimage_url.Case Sensitivity: Ensure your layer names match the casing used in the Abyssale editor.
Technical Metadata Columns
You can also include specific columns for platform-specific settings:
Type | Required Column Header Format | Content Example |
Formats |
| instant-experience-ads,email-large |
Localization |
| US en |
Tagging for naming convention |
| Campaign A |
HTML5 Click Tag |
| Page title |
Advanced: Multi-decorated text
Just like in the design editor, you can include formatting tags in your CSV to vary the style of specific words within a single text layer (e.g., bolding one word while keeping the rest regular).
For a deep dive into text formatting, check out our Text Decoration