ProteinIQ
DocumentationAPI referenceChangelog
Talk to usGet started

CSV batches

By default, each CSV row describes one complete job. Multiple input columns belong to that same experiment: two protein columns can form a complex, or heavy and light chain columns can form an antibody pair.

Import a spreadsheet

Choose the tool and primary operation before importing:

  1. Select Template to download the current input headers, or use your own column names.
  2. Select CSV to upload a file, or Paste CSV to enter text. Choose the matching Column separator: comma, semicolon or tab.
  3. In Map columns, assign custom headers to inputs, settings or Job name. Choose Ignore explicitly for notes or other unused columns.
  4. Keep Create jobs set to One row per job to preserve existing experiments. Choose a list mode only when you intend to generate new pairs.
  5. Open Preview, resolve issues and review the estimate before submitting.

Export Excel workbooks as UTF-8 CSV or TSV first. Native .xlsx import is not supported.

Reference uploaded files

Use file:sample.pdb in a cell to reference a file added to the matching input in the form. The filename must match exactly and be unique within that input. This works for structures, alignments and other formats accepted by the selected tool.

Only referenced files are included. Text entered in the regular input fields is not added to CSV jobs. File references do not read local paths or fetch URLs, and they do not split or convert the file's contents.

Vary settings by row

A column named setting.<id> overrides that setting for its row. Use the exact identifier in Column reference and examples. Empty setting cells inherit the shared value; 0 and false remain explicit values.

Setting columns work with One row per job. Keep the primary operation shared and use separate batches for different primary input modes. Tool and plan restrictions still apply to every row.

The examples cover folding, antibodies, structures and alignments. Use the CSV reference for molecular attributes and the format guide for quoting, errors and size limits.

PreviousCreating a batchNextPairing and combinations

Table of contents

Get started
WelcomeStart guideConceptsPreparing inputsRepair and validate a structure
Work and files
ProjectsJobsFiles and collectionsWorkflowsTroubleshooting analyses
Batches
OverviewCreating a batchCSV batchesPairing and combinationsBatch examplesCSV referenceCSV format and limits
Research tools
AI AssistantDatabase searchViewers
Plans and credits
CreditsJob credit usageWorkflow credit usagePricing and billingBilling and invoices
Workspace and account
Workspaces and seatsSharing and permissionsCancellation and renewalsAccount deletion
Appearance
Back to ProteinIQ