Know every step before you sign.

Choose a task below for a complete walkthrough, from preparing your data to confirming the finished transaction.

01

Prepare

Choose a path and add the details.

02

Review

See matches, blockers, and eligible rows.

03

Publish

Approve only the reviewed write.

04

Confirm

Wait for the network result.

Best for bulk data

Import list members from CSV

Select the destination list first. Every CSV row must identify an atom that already exists on the selected network before Collate can add it as a member.

Open this flow

Step by step

01

Select or create the destination list

Open Create, choose Lists, then select CSV import. Type in the List atom field and choose the correct existing result, or create and publish the list atom through the modal. Review remains unavailable until a list atom is selected.

02

Download the sample and enter existing members

Download the list CSV sample. Add one member per row, replacing the examples with the actual atoms you want to add to the selected list, then delete any sample rows you do not need.

Copy each atom's exact name and exact description from its existing graph record. The name finds matching atoms, and the description identifies the correct one when several atoms share that name. For a large set, download the sample first, then give that file and the copied graph records to an AI assistant to populate it. It must not rewrite or invent the names and descriptions, so verify every row before uploading.

03

Save, upload, or paste the CSV

Export the completed spreadsheet as a CSV file, then select Upload CSV file. You can also paste the complete CSV text into the input. Confirm that the selected list atom is still the destination you intended.

04

Preview the member rows

Select Preview CSV rows. Check every line number, member name, and description against the spreadsheet, and correct any parsing error before continuing. This step confirms that Collate read the file; it does not resolve the atoms yet.

05

Resolve the rows against existing atoms

Select Review list rows. Collate searches for existing atoms with each exact name and compares their descriptions. A clear match is selected automatically; several possible matches leave the row waiting for your decision.

06

Inspect ambiguous, missing, or existing rows

For an ambiguous row, open each candidate's details and select Use this atom for the correct one. If a row is Missing, create that atom from Atom creation, then return and review the CSV again. Skip existing means that member is already in the list and needs no new transaction.

07

Review again and confirm eligibility

Review the list again after changing a candidate or correcting the CSV. Confirm that Ready to create and Ready with matches rows are the members you intend to add. Ambiguous, missing, existing, duplicate, and invalid rows stay excluded.

08

Publish the eligible list entries

Connect your wallet on the selected network and select Publish eligible list entries. Approve one transaction containing only the eligible members, then wait for Collate to confirm the result.

Example CSV

member,description
Ethereum,A decentralized open source blockchain system
Base,A secure low cost builder friendly Ethereum L2

Keep in mind

  • • Copy the existing atom's name and description. Do not write a new description.
  • • A CSV row cannot create a new member atom.
  • • CSV list import does not create missing member atoms. Create them first, then review the CSV again.

What review may show

Ready to create

Resolved and eligible.

Ready with matches

Safely resolved with alternatives to inspect.

Ambiguous

Choose one candidate manually.

Missing

No existing member atom was found.

Every row tells you what happens next.

The label beside a row explains whether it will be created, reused, skipped, or held back for your attention.

Ready

Eligible for the next transaction.

Existing

Already available and left out.

Duplicate

Repeated in the current batch.

Ambiguous

Needs a careful candidate choice.

Missing

No existing list member was found.

Invalid

Needs a correction before review.

Take the guide with you into the workspace.

Your selected flow will open directly. Prepare freely, review carefully, and connect your wallet only when you are ready.

Open import list members from csv