How to Use Ripple Import

Get started in minutes — no configuration needed.

Installation

Install Ripple Import from the monday.com marketplace. Once installed, add it to any board as a Board View:

Open your board
Click the + button next to your existing views (Main Table, Chart, etc.)
Search for Ripple Import
Click to add it as a view

Step 1 — Upload your file

Drag and drop a CSV or Excel file onto the upload area, or click to browse. Multi-sheet Excel workbooks are supported — you'll be able to choose which sheet to import.

Don't have a file ready? Click Download Template to get a CSV or Excel file that matches your board's columns. Fill it in with your data and upload it.

Step 2 — Map and preview

Ripple Import automatically matches your file's columns to your board's columns by name and type. You can:

Adjust mappings — change which board column each file column maps to
Skip columns — set any column to "Skip" if you don't want to import it
Auto-create columns — if your file has columns that don't exist on the board, Ripple Import can create them for you
Choose a target group — pick which group on your board the items should be added to

Importing with subitems

Ripple Import can automatically detect parent-child relationships in your data. Three detection modes are available:

Type / Level column — a column in your file that indicates whether each row is a parent or subitem (e.g., "Parent" / "Subitem", or level numbers 0, 1, 2)
Indentation — subitems are indented with spaces or tabs in the item name column
Parent reference — a column that contains the name of each row's parent item

You can also add subitems to an existing item on your board. Select "Add subitems to existing item" and pick the parent from the dropdown.

Multi-level boards

If your board is a multi-level board, Ripple Import automatically detects this and adapts the entire experience. Multi-level boards support up to 5 levels of nesting (Level 0 through Level 4). You can:

Import items with multiple levels of hierarchy in a single upload
Add children to any existing item at any depth
Download templates with level indicators

All columns are shared across every level on multi-level boards — no separate column assignment is needed.

Step 3 — Import

Click Import and Ripple Import creates the items on your board. You'll see real-time progress showing how many items have been created. When it's done, you'll see a summary with counts for items created, subitems, any skipped duplicates, and any errors.

Duplicate detection

If your board already has items with the same names as rows in your file, Ripple Import can skip them automatically. Select "Skip duplicates" in the mapping step to avoid creating duplicate items.

Header hint tags

For advanced control, you can add tags to your file's column headers to specify the column type:

[status] Priority — maps to a Status column
[date] Due Date — maps to a Date column
[numbers] Budget — maps to a Numbers column
[email] Contact — maps to an Email column

Tags are optional — Ripple Import auto-detects column types when no tags are provided.

Import to a new board

Select "Start fresh from file" to create a brand new board from your file. Ripple Import will create the board with columns matching your file and import all data into it.