# 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:&#x20;

{% file src="<https://3271682270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWKyUXOqIKtqE7cAUE2yQ%2Fuploads%2FN00M5esIOV0KDsJC5jbV%2Flabware%20defs%20for%20Omnistainer.zip?alt=media&token=53f347a5-8bc7-4ff0-bc4c-6ba61b1cd79d>" %}
Opentrons Labware Definitions .JSON Files&#x20;
{% 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="../blue-dye-demo-automated-protocol" %}
[blue-dye-demo-automated-protocol](https://docs.parheliabio.com/product-guides/blue-dye-demo-automated-protocol)
{% endcontent-ref %}

{% content-ref url="" %}
[](https://docs.parheliabio.com/product-guides/automation-opentrons-ot-2-setup)
{% endcontent-ref %}

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

<figure><img src="https://3271682270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWKyUXOqIKtqE7cAUE2yQ%2Fuploads%2FvH7xnl4AtWNcAnFnrRXs%2FScreenshot%202023-05-23%20at%205.49.32%20PM.png?alt=media&#x26;token=6c3b9d4d-e3d4-4f80-ab7a-4b1ac5d624e9" alt=""><figcaption></figcaption></figure>

And the error details will look like:

<figure><img src="https://3271682270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWKyUXOqIKtqE7cAUE2yQ%2Fuploads%2FkDa7eHWkWqsVnJaJXUSH%2Fmissing%20labware%20definition%20error%20window.png?alt=media&#x26;token=a0518a48-fdee-4a5d-a86c-c3536ecb06fe" 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="https://3271682270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWKyUXOqIKtqE7cAUE2yQ%2Fuploads%2FBQ9MwRBTek1WREVcFUJ7%2FBlue%20dye%20Demo%20opentrons%20window%20C12.png?alt=media&#x26;token=ea058020-8f66-4148-8191-6d6327a0b146" 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>
