---
description: Managing study projects
---

# Programs

Before any studies can be added to Study Tracker, you must first add at least one [Program](../../key-concepts#programs). Programs are defined as the top-level unit of work in your organization, under which you can register as many studies and assays as you like.&#x20;

## Creating a new Program

You can manage programs from the 'Programs' tab of the Admin Dashboard. Click the 'New Program' button on this page to enter the program creation form. Most of the fields on this form are important and required, so take a moment to consider them:

<figure><img src="https://157675233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzxr1lQXVcdFuqP1WfyV%2Fuploads%2FJwsAh8FKrsoercB9pXUD%2Fimage.png?alt=media&#x26;token=42d243f1-b218-4b7e-9218-6b6a0763a44c" alt=""><figcaption><p>The program form</p></figcaption></figure>

* **Name**: Your program must have a unique name. It should not be too long, but should be clear in its definition.
* **Code**: This should be a short alphanumeric string, preferably upper-case. It will be used as a prefix for generating [study and assay codes](../../key-concepts#study-codes).&#x20;
* **Description**: Provide a brief description for your program, explaining its purpose and goal.
* **Active**: Unless this is a legacy program no longer in use, this value should be set to 'Active'.

### Adding an Electronic Laboratory Notebook (ELN)

If you have configured integration with an ELN (such as [Benchling](../integrations/benchling)), you can connect your program to an existing project in the application. Choose the project you would like to link your program to from the 'ELN Project' dropdown and all of the required fields will be populated from the ELN platform. It is possible to use the same ELN project for multiple Study Tracker programs.

<figure><img src="https://157675233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzxr1lQXVcdFuqP1WfyV%2Fuploads%2FUWRnHjyIzHyUgkoTnwEJ%2Fimage.png?alt=media&#x26;token=d1fdea0a-b9d5-450e-992a-49c36ca40ec9" alt=""><figcaption><p>ELN Project selection</p></figcaption></figure>

{% hint style="info" %}
Be sure to create your ELN projects _**before**_ adding programs to Study Tracker. Benchling does not support remote creation of projects through their API. It is also important to make sure that the API account Study Tracker is using to communicate with the ELN has write access to requested projects.
{% endhint %}

### Adding File Storage

All programs require a [file storage location](storage-folders) to create their folder hierarchy for child studies and assays. Select a [root folder](../storage-folders#adding-root-folders) from the 'Parent Folder' dropdown to use. A new folder named after your program will be created within this root folder and will be used as the default file storage location for all studies and assays created within it.

<figure><img src="https://157675233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzxr1lQXVcdFuqP1WfyV%2Fuploads%2Fer16Yf3Lxo0Vhs6SpoTP%2Fimage.png?alt=media&#x26;token=c24ec5d1-fac4-4421-a729-22ba458641c7" alt=""><figcaption><p>File storage location selection</p></figcaption></figure>

### Adding Git Repository Group

You can optionally also create a group in any integrated Git server (eg. [GitLab](../integrations/gitlab)) to store Git repositories created for studies and assays within your program. Select the root Git Project Group from the dropdown and a subgroup for your program will be created within it.&#x20;

<figure><img src="https://157675233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzxr1lQXVcdFuqP1WfyV%2Fuploads%2FpR8n5Qp3zXuJ2YhzNFQa%2Fimage.png?alt=media&#x26;token=7252e8af-435e-4ce7-90cd-63a842b9bdec" alt=""><figcaption><p>Git group selection</p></figcaption></figure>

## The Program Details Page

After successful creation of your new project, you will be redirected to the Program Details page. From here, you can modify your program, browse all associated studies, and view all activity in the timeline. Links are also provided to the newly-created folders in your file storage and ELN systems.

<figure><img src="https://157675233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzxr1lQXVcdFuqP1WfyV%2Fuploads%2FDenPvUchVpqZpo6yMjyH%2Fimage.png?alt=media&#x26;token=5276179f-1361-40a6-9ac3-7aa75b47c78b" alt=""><figcaption><p>The program details page</p></figcaption></figure>
