# GetstartedImportaprotocol
### Citation
OpenTrons. (2023). Get started: Import a protocol. OpenTrons Support. Retrieved from [https://support.opentrons.com/s/article/Get-started-Import-a-protocol](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol\&sa=D\&source=editors\&ust=1684532198667225\&usg=AOvVaw1MBR3Bb8MIAs5kCAEl5KHr)
URL: [https://support.opentrons.com/s/article/Get-started-Import-a-protocol](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol\&sa=D\&source=editors\&ust=1684532198668104\&usg=AOvVaw2xgiWC2lq6wX0qp_vjYYkg)
*
### Title: Get started: Import a protocol
After you’ve attached pipettes and finished deck, tip length, and pipette offset calibrations, you can import a protocol.
[Introduction](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Intro\&sa=D\&source=editors\&ust=1684532198669548\&usg=AOvVaw1JluM2jTjpQ2mc2S-4ihnI)
[Before starting](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Before_starting\&sa=D\&source=editors\&ust=1684532198670039\&usg=AOvVaw1aNWWOuAIyEP0X5cVG8_Cu)
[Procedure](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Procedure\&sa=D\&source=editors\&ust=1684532198670476\&usg=AOvVaw1BANwRh9fOO88LB-Mdi6QV)
[Step 1: Import Python (.py) or Protocol Designer (.json) file](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Step_1\&sa=D\&source=editors\&ust=1684532198670949\&usg=AOvVaw3qGMBjk0IFgjHHN8h7pdXx)
[Troubleshooting: “Module not found” or “File not found” errors during protocol analysis](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23TS_Protocol_analysis\&sa=D\&source=editors\&ust=1684532198671491\&usg=AOvVaw10UyScRfv7ZyDW7ZVgB2MH)
[Step 2: Select protocol](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Step_2\&sa=D\&source=editors\&ust=1684532198671994\&usg=AOvVaw2BQPvq3Nod-BG4HgDHAV4i)
[Step 3: Proceed to run setup](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Step_3\&sa=D\&source=editors\&ust=1684532198672508\&usg=AOvVaw0lNACoQruN7ojCBKn_JYWG)
[Troubleshooting: Help! I don't see any available robots listed / I'm unable to connect](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23TS_Unable_to_connect\&sa=D\&source=editors\&ust=1684532198672992\&usg=AOvVaw1qZrehsCyrctZGXFgM1f5u)
[Step 4: Review details on run setup page](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Step_4\&sa=D\&source=editors\&ust=1684532198673484\&usg=AOvVaw0M5BnVyS7m96S9hMcmYvOG)
[Setup](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Setup\&sa=D\&source=editors\&ust=1684532198673959\&usg=AOvVaw08v9Dysk66RRF1gpi-RDTN)
[Module Controls](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Module_Controls\&sa=D\&source=editors\&ust=1684532198674460\&usg=AOvVaw0tu2wfI7h4lcG7iDzO3PND)
[Run Preview](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Run_Preview\&sa=D\&source=editors\&ust=1684532198675461\&usg=AOvVaw1JTQKUU6d2iDVStTN17p21)
[Step 5: Start run](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Step_5\&sa=D\&source=editors\&ust=1684532198676494\&usg=AOvVaw1IfmbGL1HR32IQ_WOYz8gW)
[Continue to the next section](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Import-a-protocol%23Continue\&sa=D\&source=editors\&ust=1684532198677520\&usg=AOvVaw0hrnxo-QPCFFSXwaKyc5ug)
###
### Introduction
### Before starting
If you haven't yet decided on a protocol method, see [Get started: Choose which protocol method is right for you](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Choose-which-protocol-method-is-right-for-you\&sa=D\&source=editors\&ust=1684532198678842\&usg=AOvVaw1C8YCuz638Cj2IeZioywbX).
###
### Procedure
### Step 1: Import Python (.py) or Protocol Designer (.json) file
In the Opentrons App, select the Protocols tab. If you have not imported any protocols, you will be able to select Choose File or drag and drop to import your Python (.py) or Protocol Designer (.json) file.
If you have already imported a protocol, this is also where you will see it listed.
####
#### Troubleshooting: “Module not found” or “File not found” errors during protocol analysis
When a protocol is imported into the app, it undergoes protocol analysis local to the Opentrons App (this is before it is simulated on the OT-2 itself). This process extracts information from the protocol and loads it into the app to display the metadata and graphics.
If you are using the Python API and see an error such as “Module not found” for Python packages or “File not found” for csv files loaded onto your OT-2, please review the troubleshooting steps found in [Protocol analysis](https://www.google.com/url?q=https://support.opentrons.com/s/article/Protocol-analysis\&sa=D\&source=editors\&ust=1684532198681108\&usg=AOvVaw1fFlCh7tIcOqd2dW-KIu1e).
###
### Step 2: Select protocol
To proceed, select the protocol you want to run.
Note: You can select Import to add more protocols. You can also change the way the list is organized by selecting a different option from the Sort by dropdown menu in the upper right.
###
### Step 3: Proceed to run setup
After selecting your protocol, you'll be taken to the protocol overview page. Select Run protocol to continue setting up your run.
You will be prompted to choose an available robot before you can select Proceed to setup.
####
#### Troubleshooting: Help! I don't see any available robots listed / I'm unable to connect
If this is your first time connecting to the robot, please see:
* [Get started: Connect to your OT-2 over USB](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Connect-to-your-OT-2-over-USB\&sa=D\&source=editors\&ust=1684532198683707\&usg=AOvVaw2gkxUEpBxqjyC4UVyD9Nbx)
* [Get started: Connect to your OT-2 over Wi-Fi (optional)](https://www.google.com/url?q=https://support.opentrons.com/s/article/Get-started-Connect-to-your-OT-2-over-Wi-Fi-optional\&sa=D\&source=editors\&ust=1684532198684287\&usg=AOvVaw0HpjTjyZCsx1S34KFbxCwt)
If you've successfully connected to the robot before but are suddenly unable to, please see:
* [Troubleshooting problems with USB connections](https://www.google.com/url?q=https://support.opentrons.com/s/article/Troubleshooting-connection-problems\&sa=D\&source=editors\&ust=1684532198685021\&usg=AOvVaw3tbEWY5XjfPKqWWeU7CEXv)
* [Troubleshooting problems with Wi-Fi connections](https://www.google.com/url?q=https://support.opentrons.com/s/article/Troubleshooting-problems-with-Wi-Fi-connections\&sa=D\&source=editors\&ust=1684532198685591\&usg=AOvVaw3KllK-kxy-M-tWmJENgIK4)
###
### Step 4: Review details on run setup page
Details about your protocol are broken down into 3 tabs on the run setup page:
* Setup
* Module Controls
* Run Preview
####
#### Setup
The Setup tab displays the statuses of Robot Calibration, Module Setup (if your protocol uses Opentrons modules), Labware Setup, and Liquid Setup. Click on a step to expand it.
Note: If your protocol does not use any modules, the Module Setup step will not be shown.
Robot Calibration allows you to review current calibration data and will flag any required calibrations that are missing or need to be redone.
Module Setup displays information about the modules used in the protocol.
Labware Setup displays information about labware used in the protocol. This is also where you can run Labware Position Check. See [How Labware Offsets work](https://www.google.com/url?q=https://support.opentrons.com/s/article/How-Labware-Offsets-work-on-the-OT-2\&sa=D\&source=editors\&ust=1684532198689551\&usg=AOvVaw1G74g86d-hPbaH2B84I35E) for additional details.
Initial Liquid Setup displays the volume and starting location of each liquid used in the protocol. Click on a liquid to further expand it.
You can click on an expanded liquid's details to see specific information about the labware containing the liquid, as well as its starting deck state.
####
#### Module Controls
The Module Controls tab allows you to interact with connected Opentrons modules that will be used in your protocol.
The protocol in the example shown throughout this article uses a Magnetic Module. You can set the engage height of the magnets by selecting the three-dot menu (⋮) > Set engage height.
####
#### Run Preview
The Run Preview tab displays a preview of your protocol's steps.
###
### Step 5: Start run
When you're ready to run your protocol, select Start run at the top.
Copyright © 2023 Opentrons
---
# 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/background-knowledge-llm-semantic-training-data/background-info-and-lens-training-docs/opentrons-setup-guides/getstartedimportaprotocol.md?ask=
```
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.