# Importing labware definitions

Labware definitions are specialized JSON format files that contain essential information about the labware's geometry, such as the number of wells, XY positioning, and well depth. These files are crucial for enabling the Opentron OT-2 robot to accurately access the samples. To facilitate this process, we have developed custom labware definitions specifically for Parhelia Omni-stainer instruments and reservoirs. To get started, simply **download our GitHub** [**here**](https://github.com/parheliabio/ot2-scripts/archive/refs/heads/main.zip), unzip the files, and **follow** [**this guide**](https://support.opentrons.com/s/article/Using-labware-in-your-protocols) to import the JSON files from the labware folder into the Opentrons app.

Click below if you wish to download just the labware definition files: 

{% file src="/files/A11WIT3tLhlwuXRO7vDS" %}
Opentrons Labware Definitions .JSON Files 
{% endfile %}

You may have to upload custom labware definitions one at a time.

## Troubleshooting

### Protocol analysis failure

In this example the protocol has already been configured and downloaded from StainWorks, and uploaded to Opentrons App, this process is covered in these two document pages.

{% content-ref url="/pages/C6Pql6XPM8NNOELpQPXx" %}
["Blue Dye Demo"  Automated Protocol](/product-guides/blue-dye-demo-automated-protocol.md)
{% endcontent-ref %}

{% content-ref url="/pages/xzxNw62cWQpoXqHIkjIj" %}
[Automation (Opentrons OT-2) Setup](/product-guides/automation-opentrons-ot-2-setup.md)
{% endcontent-ref %}

If a protocol is loaded but the labware definition is missing the protocol will show up looking like:

<figure><img src="/files/ekIyNZIRXbXXmRZqOTkf" alt=""><figcaption></figcaption></figure>

And the error details will look like:

<figure><img src="/files/jV9nfOEikvgfmPEWpB1G" alt=""><figcaption><p>Missing labware definition error details</p></figcaption></figure>

If this happens, import the missing labware definitions, and then click "Reanalyze protocol" in the Protocols tab. If the labware definitions are not missing, and you click on the protocol you should see something like this:

<figure><img src="/files/LPqzd6jJFTDqBfAevfP7" alt=""><figcaption><p>Example of protocol with correct labware definitions, the lack of a blue check next to the labware is normal and does not mean there is any missing labware definitions.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parheliabio.com/product-guides/automation-opentrons-ot-2-setup/importing-labware-definitions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.