Create and register proteins in Benchling Biologics

Benchling Biologics registration takes DNA or amino acid sequences as input and automatically creates and links all component entities at once, including domains, chains, variable pairs, and the protein entity itself, so you don't have to build and link each one manually. Use this article to prepare your spreadsheet, register a batch of antibodies, and review the entities Benchling creates.

During registration, Benchling annotates sequences with CDRs, framework regions, and germline genes. It then validates each sequence for structural soundness, checking factors like CDR length, domain type, and light chain pairing. If any sequence fails validation, nothing in that batch is registered, and you'll receive an error report to fix and resubmit. 

Note: Benchling Biologics requires a separate license and must be configured before registration is possible. See Configure Benchling Biologics schemas and formats to get started.

Understand the registration flow

Protein registration is an asynchronous process. After you submit, Benchling runs a pipeline that creates and links all entities, annotates sequences, and validates them against the selected germline. You'll receive an email notification when the job is complete — either with a link to your summary dataset or a CSV of errors to fix. Registration is designed to be all-or-nothing — if Benchling detects errors during validation, nothing is created and you'll receive an error CSV. 

Benchling creates the following entity types during a single registration run:

• DNA domains and/or AA domains
• DNA chains and/or AA chains
• DNA variable pairs and/or AA variable pairs
• Protein entities

Starting points: You can start from either domains or chains, and provide sequences as DNA bases, amino acid residues, or Registry IDs of existing entities. Benchling detects the input type automatically. If starting from domains, Benchling concatenates chains from those domains. If starting from chains, Benchling decomposes chains into domains. In both cases, DNA inputs are automatically translated to AA.

Note: AA inputs are not back-translated to DNA. If you need DNA sequences for your components, prepare and register them before or after protein registration.

Pre-requisites & limitations 

Each format requires a specific spreadsheet template with format-specific column headers. Download the template from within the registration flow.

• Column headers must match the template exactly. Column order doesn't matter
• Each column must use a single input type across all rows — raw DNA bases, amino acid residues, or an existing registered entity name or Registry ID. Input types can vary between columns, but not within a single column
• You can register a maximum of 1,000 antibodies per run

Custom fields on protein entities can't be set during registration. You can update additional metadata on registered entities after registration.

Notebook entry sections must be enabled on your tenant for the receipt feature during registration to work.

Register Antibodies

Configure your registration

1. Click Global create, hover over Protein, and click Create proteins
2. Select a format from the format picker
3. Select the associated schema — Benchling auto-selects the schema if only one exists for that format
4. Select a germline and numbering scheme from the Germline dropdown. Available germlines and schemes are shown in the dropdown.
5. Select your starting protein component: Domains or Chains
6. If starting from domains, select whether you'll provide variable pair entities or individual VH and VL domains
7. Click Next
8. Click Download template to get the prescribed columns for your format and starting component type
9. Fill in the spreadsheet with your sequence data

Upload your spreadsheet

Using the spreadsheet you prepared previously, upload it to complete registration.

1. Upload the completed spreadsheet. Benchling performs upfront validation and flags missing columns or incorrect headers before proceeding
2. Click Next

Map columns

1. Review Benchling's column type detection — Benchling identifies whether each column contains existing entities or raw sequences, and whether raw sequences are DNA bases or amino acid residues
2. Correct any column types if needed, then click Confirm column types
3. Click Next

Finalize & create

1. Review the entity creation summary — this shows each component type, the number of entities to create, and the schema they'll be created in
2. Select the appropriate schemas for any component types not auto-assigned
3. If your spreadsheet includes DNA inputs, select the genetic code for DNA-to-AA translation
4. Select the project folder where proteins and components will be saved
5. Optionally, search for and select an existing Notebook entry to receive a summary receipt when registration completes 
6. Click Create and register

Note: After clicking Create and register, a notification appears with a link to track registration progress. Don't edit anything on that page — it's for monitoring status only.

Review registration results

Benchling sends an email notification when registration completes, whether it succeeded or encountered errors.

If registration encounters errors:

1. Open the error notification email
2. Click Download errors to download a .csv (protein_creation_errors.csv) listing the issues
3. Review the errors — each row identifies the issue and the affected sequence
4. Fix the issues in your spreadsheet
5. Restart the registration flow from Global create

If registration succeeds:

1. Open the success notification email
2. Click View summary to open the summary Dataset — this lists all entities created, reused, or merged during registration, with a column per component type indicating whether each entity was created, referenced, or merged
3. If you sent a receipt to a Notebook entry, open the entry to find a new section with a link to the Dataset

Note: If Benchling finds an existing entity that matches a sequence you provided, it marks that entity with a yellow icon in the summary.

View registered proteins and sequences

Once registration is complete, open a protein entity to explore its structure and metadata.

Each protein entity includes:

• A Format field showing the VERITAS string for the format
• Chain and domain fields linking to each registered sequence
• Fieldset fields, including any computed biochemical property fields configured on your tenant
• A protein map (glyph) showing the 2D structural visualization of the molecule

Navigate the protein map: Hover over a domain in the glyph and click to open a sequence preview of that component. In the glyph, distinct chains are color-coded, variable domains appear darker than constant domains, and hinges and linkers are represented as black lines. Click a chain name in the legend to open the full chain sequence.

Review annotation data on sequences: During registration, Benchling annotates all new sequences and writes structured metadata to the relevant schema fields. The following data is available on domain sequence entities:

• CDR1, CDR2, CDR3 sequences
• Framework region annotations
• Closest-related V gene, J gene, and C gene, with percent identity
• Liabilities (asparagine deamidation, methionine oxidation, N-linked glycosylation, aspartate isomerization, lysine glycation, aspartic acid–proline cleavage, hydrolysis)
• Mutations and warnings (truncated framework regions, constant domain mutations)

Note: Benchling only annotates new sequences during registration. If you reference an existing entity by name or Registry ID, or if Benchling matches a sequence to an existing entity via uniqueness checks, that existing sequence is not re-annotated or updated.

FAQ

Q: Can I use registration tables to register protein entities? 

A: No. Protein registration is only supported via Global create or the API. Registration tables are not supported for protein schemas. Component entities (domains, chains, pairs) can be pre-registered via registration tables if needed.

How long does registration take? 

Registration time varies by format and batch size. As a general estimate, registration takes 15–20 seconds per antibody after startup. Registration may take longer in larger registries.

What happens if registration encounters an error? 

Registration is all-or-nothing — if any error is detected, nothing is created and you'll receive an email with a CSV summarizing all errors. Fix the issues and restart the flow.

Can I include sequences that are already registered in Benchling? 

Yes. In your spreadsheet, provide the entity name or Registry ID instead of raw sequence data. Benchling reuses the existing entity rather than creating a new one. Existing sequences are not re-annotated during registration.

How many antibodies can I register in a single run? 

Up to 1,000 antibodies per run, with the following additional limits:

• 4,000 chains per run
• 14,000 domains per run
• 45 domains per protein
• 18 domains per chain
• 1,200 amino acid residues per chain
• 3,600 DNA residues per chain
• 41,000 total entities per run

Will Benchling re-annotate existing sequences if I reference them in my spreadsheet? 

No. Benchling only annotates new sequences during registration. Existing sequences referenced by name, Registry ID, or matched via uniqueness checks are not updated or re-annotated.