Documentation / Connections / Sites

Trials

How site records connect to trial records in TrialStack.

Site trials tab showing connected trials with role and principal investigator details. Site trials tab showing connected trials with role and principal investigator details.

This is a dual-bound connection. The same junction links a site to a trial and a trial to a site. Both directions share the same underlying record.

Why it matters

  • a study is executed at one or more sites with specific roles and named investigators
  • reviewers need to understand which site activity belongs to which trial
  • site readiness, capacity, and investigator assignment must stay connected to the right study
  • the junction captures site code, role, and principal investigator for operational clarity

Dual-bound relationship

flowchart LR
  S[Site] -- "role · PI · version" --> T[Trial]
  T -- "site code · role · PI · version" --> S

In the product

Site trials tab showing connected trials in light mode. Site trials tab showing connected trials in dark mode.

The site record lists connected trials with role and principal investigator context directly on the tab.

Add trial to site dialog in light mode. Add trial to site dialog in dark mode.

Connecting from the site side captures the target trial, role, optional site code, and principal investigator.

Edit trial-site connection dialog in light mode. Edit trial-site connection dialog in dark mode.

Existing links can be updated in place when the site code, role, or principal investigator changes.

Junction fields

From the site page (site → trial)

ColumnDescription
RoleThe site’s role in the trial — maps to trialSiteRole dictionary. Default when connecting: principal_site
PIThe name of the principal investigator assigned to this site for the trial
VersionJunction version counter

From the trial page (trial → site)

ColumnDescription
Site CodeThe trial-specific code assigned to this site
RoleSame trialSiteRole value
PISame principal investigator name
VersionJunction version counter

Operations

ActionFrom site pageFrom trial page
ConnectPick a trial (default role: principal_site)Pick a site
DisconnectRemove the trial linkRemove the site link
ReconnectUpdate role / PIUpdate site code / role / PI

From each side

  • Use Sites for the site record.
  • Use Trials for the governing study record.