Skip to main content

Generate CSV link

Download matching records as a CSV file.

Generate CSV link · Activation

Collects the records that reach this step and produces a CSV file to download. This is an end step.

When to use it

Use it when you want the results out of Ocean as a file — to share a list, load it elsewhere, or review a run.

What it does

It gathers every record that reaches the step across the run and produces a single CSV with their fields. The download link appears on the step in Activity.

Configure it

  • Columns — which upstream fields become columns, chosen from a searchable list grouped by the step that produced them. Leave it unset to include every field produced upstream; narrow it once you know which fields you actually need.

Add it at the end of a path. It collects whatever records arrive.

Cost

No credit cost. See Credits in workflows.

Gotchas

  • No file exists until the whole run finishes. This step waits for every record in the run before it writes anything, so there's nothing to download while a run is still in progress. If a run stops partway (for example, out of credits) before reaching this step, no file is produced — but Runs states why instead of leaving the step blank.

  • Records that failed or were dropped earlier never reach this step, so they're simply absent from the file — not included with an error marker. If your CSV has fewer rows than you expected, check Activity for records that failed or were dropped upstream. For a file that covers every enrolled record including failures, use a run's Download report on the Runs tab instead — this step only ever sees records that actually reached it.

  • The link only appears in Activity and Runs, on this step's row, once the file is ready — nothing is emailed or posted automatically. Ocean warns you at publish time if this step ends the workflow with nothing after it; add Notify if you want someone told the file is ready. See Publish, drafts, and versions.

  • Only fields produced by earlier steps can be added as columns — add the steps that produce what you need before this one.

Did this answer your question?