Premium Feature — Available in the Professional Edition of Sample Manager and all Premium Editions of Biologics LIMS. Also available when Sample Manager is used with a Premium Edition of LabKey Server. Learn more or contact LabKey.

Projects allow users to organize and partition sensitive data into projects within the application, all while maintaining a shared storage environment. Data structures and resources like reagent lists can also be shared lab-wide to support consistency, while individual teams work with their own secured data.


In this video, you will see how to configure and use Projects to work with data across different teams using Sample Manager Professional.


Without the use of Project organization, Sample Manager does not partition data for different teams. Permissions are granted to all data simultaneously in a single "container".

When you enable Projects in the Professional Edition of Sample Manager, data can be grouped and partitioned by teams.

Home Project and "Sub" Projects

The home project is at the top level and provides shared definitions and storage configurations. Data can be added directly in the home project or to the individual "subcontainer" projects as appropriate. Permissions are controlled independently in each project, making it easy to partition separate team spaces.

  • Sample Types, Source Types, etc. are defined in the home project to support lab-wide consistency. You will not see options for adding these definitions in subprojects.
  • Storage systems like freezers are also defined in the home project to match the shared physical space. Individual teams can see the details of stored samples they have permission to read, but only see space allocated to other teams as "occupied".
  • Reports and views of all data you have access to can be created in the home project, summarizing all the data an individual user has access to.
  • Create shared resources like reagents in the home project so that they can be shared & viewed by all projects.
  • Use project permissions to partition each study from one another making it easy to operate in compliance with regulations.

Sample Status Values in Projects - 23.4 Upgrade Note

Sample Status values are defined in the home project and will be 'inherited' by all sub-projects. New custom status values can only be created in that home project.

If you have been using Projects prior to version 23.4 and had custom Sample Status values defined in sub-projects, any unused values will be deleted. Existing custom status values in sub-projects will be retained in the sub-project where they are defined. If you would like existing sub-project status values migrated to the home project level, please contact your Account Manager for assistance.

Manage Projects

To manage projects, select Administration from the user avatar menu, then click the Projects tab. This tab is only available when you are in the home project and lists existing projects.

Click the name of a project to make any changes to its settings.

Create New Project

Click Create to add a new project. Enter the Project Name and uncheck the checkbox if you wish to provide a different label.

Follow the steps below if you want to limit the data and/or storage that are shown in your new project. The default is that everything from the home project is available in all projects.

Click Create Project. When first created, only administrators can view the new project. This can be useful when configuring a new project for a team to ensure the users only access it when ready. Click Update project permissions if you want to grant access immediately. You can also reach this page by selecting the project from the menu, clicking Dashboard, then choosing Administration from the user avatar menu and clicking Permissions.

Delete Project

To delete a project, either:

  • Click it's name from the Projects dashboard (select Administration from the user menu in the home project, then click Projects).
  • You can also select Administration within the project you want to delete, then click the Settings tab.

Click Delete Project.

When a project is deleted, all data contained in it will also be deleted. The administrator will see a warning detailing the project's contents and need to confirm to proceed.

Select Data in Project

An administrator can restrict the Source Types, Sample Types, and Assay Designs that are visible in a given project. This can be configured during project creation or later by editing project settings.

You'll see all the Source Types, Sample Types, and Assay Designs available in the home project. By default, everything available will be visible in the project, but you can uncheck boxes for types of data that will not be used in the project. For example, in this project, we won't be using "Labs", "DNA", or "Chemistry" or "NAb" assays. If data is present, you'll see a message about what will no longer be visible.

Note that 'hiding' or deselecting a data structure here does not delete any data that may exist using it. It just simplifies dropdown menus for users. The hidden entities will not be seen, but will still be present (and lineage relationships preserved). Nor does hiding a type of data prevent it from being used in the future if these settings are edited.

The projects in which a given data structure is visible can also be set while creating or editing the data structure itself in the Projects panel. For example, if the "Labs" Source is not in use for Project Beta, the Projects panel might look like this:

Select Project Storage

An administrator can limit the storage systems that are accessible from a given project by using checkboxes in the Project Storage panel. For example, if you wanted to create a project for a team that would only work with a single freezer in their local lab, you could hide all other storage systems.

Note that this does not delete any storage or change how samples are stored in the hidden freezers, it just simplifies the dropdown menus for users in the project.

The projects in which a given storage system is visible can also be set while creating or editing the storage definition using the Projects panel below the hierarchy. For example, if this freezer is not in use in Project Beta, that box can be unchecked:

Work within Projects

Once one or more projects have been defined, the main menu will include the name of the current project and a panel on the left for selecting the home project or one of the "subprojects". Each user will see only the projects to which they have access.

To navigate, click the name of the desired project, then the page of interest from the main menu. When you hover over a project name, you'll see quick links to key pages for that project:

  • Dashboard
  • Administration

When you are in the home project, you can add or manage data and definitions like Sample Types and Assay Designs for all the projects to be able to share.

When in a project, you will still see data for all projects you can access, but additional data added will only be available in that project and visible only to users permitted to see that project's contents.

Note that changes like editing a Sample Type definition in a project require permission to make those changes at the home project level and they will apply to all projects.

Learn about actions across projects in this topic:

Best Practices

  • Home Project
    • All users must have Read access to the top level project.
    • Recommended: Only assign non-admin users Read access (and Storage Editor as appropriate) in the top level Home project. (Edit/add permissions will be granted in individual projects.)
    • The Home project is the place to create Source Types, Sample Types, Assays, ELN & Workflow Templates
    • All storage must be defined here.
    • Add all "shared resources" here that you want to be able to access in other projects, such as shared reagent lists, etc.
  • Sub Projects
    • Project/Study/Team-based access to sources, samples, assay data, workflow & ELNs.
    • Within a sub project, users can edit/update their project data.
    • From the home project, users can read their project data (and all data they can access).
    • For data that is not shared, create a project that everyone has access to.

Related Topics


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all