Skip to main content
A protocol in Bower is your lab’s own step-by-step procedure for a method: “how we run PCR in this lab”, not the published method. Protocols live in their own library, and you can tag, link and search them like anything else in Bower. A protocol is made of:
  • Steps grouped in sections, lettered and numbered so everyone refers to the same step.
  • Typed values in each step, such as temperatures, volumes and durations, that Bower can check.
  • Capture steps that say what to record at that point: a photo, a video or a voice note.
  • A sidebar for parameters, materials, recipes, safety notes and other reference material.
  • Versions that lock once approved.
  • Runs, a record of each time someone worked through the protocol.
To change a protocol, edit its steps in a draft version. Bower writes the protocol’s plain text from the steps, for search and for AI apps, so you never edit that text directly.

How do I create a protocol?

  1. Click Protocols in the left rail.
  2. Click New protocol.
  3. Choose one:
    • Drop a PDF or Word method. Drop a PDF or Word (.docx) document onto the window, or click to choose one, then click Create protocol. Bower reads the steps out of it, and you correct anything it gets wrong.
    • Start from scratch. You get a draft with one section, Procedure, ready for its first step, and empty Acceptance criteria, Materials & equipment, Safety and Troubleshooting sections in the sidebar. Rename or remove any of them.
Any procedure can be a protocol: a lab method, a general SOP, a maintenance routine or the steps for troubleshooting an instrument. Create and edit protocols on the web, or build one by talking to Bower in a live session: see Creating a protocol by voice. The Bower app on your phone is otherwise for opening and running them.

Can I turn a note into a protocol?

Yes. Open the note, click ⋮, then Convert to protocol. Bower opens the protocol page, lays your text out as steps, and keeps the text as the protocol’s source file, Original note.md.

What happens while Bower reads my document?

The page shows Reading your document, or Reading your protocol for a converted note, and the library shows Importing. A long protocol takes a few minutes; you can leave the page while it works. If Bower can’t find enough procedural detail, or reading stops partway, the page says why. What you can do next depends on where the protocol came from:

What’s on a protocol page?

At the top are the title and the version bar, which shows the version’s state, such as draft or approved, and its name. Click the name to rename the version, for example “Rev C”. Once a protocol has more than one version, the header shows the number and state together, such as ● v2 approved. The dot is green for the version runs use, blue for a draft and gray for an earlier version. To open another version, click it in Lineage in the sidebar. While you’re on the version runs use and a draft exists, a line under the header says so, with a link to open the draft. A protocol opens on its newest version, which may be a draft. Execute Protocol appears only on the version runs use. On a draft, a line under the header names that version, such as Runs use v2 until this is approved. Open v2; click Open v2 to go to it. Below the version bar:
  • Method holds the sections (A, B, C) and their steps (A.1, A.2, B.1). Steps outside a section are under Not in a section. Expand all and Collapse all open or close every section.
  • The sidebar sits beside the method. See What goes in the protocol sidebar?
Each step has a type icon (Do, Wait, Hold, Check or Note), a title, its text, and sometimes a note on why it matters. Attached pictures, videos and files appear below the step.

How do I edit steps and sections?

In a draft:
  • Click Add step or Add section.
  • Drag a step by its handle to reorder it or move it to another section, or use Move up, Move down and Move into.
  • Click a step’s icon to change its type.
  • Hover over a step and click Remove step to delete it.
  • Use a section’s actions to merge it into the one above, or remove it.
  • Click Add media to attach a picture, video or file to a step.
Changes save automatically. Undo and Redo are at the top of the page, or press Cmd+Z and Shift+Cmd+Z.

What are typed values?

A typed value is an amount with a unit, such as 37 °C, 5 mL or 10 min, and how precise it is. Typed values appear as highlighted chips in the step. When Bower imports a protocol, it marks the values it finds. A value it isn’t sure about has a warning color and a dashed underline until someone checks it. Check it against your source before you rely on it. Click a value to see the wording it came from (The document said …) and correct its amount, unit and precision: Exact, About, Range or Until. If no precision is selected, the document didn’t state one. Click Remove: not a value if it isn’t a value. To add a value, click Insert a typed value in the step’s toolbar, or type / and choose Value. Reagents and equipment Bower recognizes are underlined. Hover over one to see what Bower took it to be.

What are capture steps?

A capture step asks the person running the protocol to record a photo, video or voice note at that point, such as a photo of a gel. In a draft, hover over a step, click Add capture, and choose the type. A step asks for one capture at most; choose Nothing to clear it. Bower also marks capture steps when your imported document asks for a photo, video or voice note.

What goes in the protocol sidebar?

The sidebar holds reference material for the steps. Below Lineage and Runs, it starts with Parameters, the values your lab chooses for each run:
  • Options: a list to choose from. Press an option to make it the default.
  • Range: a number with a minimum, maximum, unit and default.
  • Text: free text, with an optional default.
Parameters stay at the top of that group and can’t be moved or removed as a section. The built-in sections below them are:
  • Acceptance criteria: what a successful run looks like.
  • Materials & equipment: what you need, with vendor and catalog number.
  • Recipes: buffers and mixes the steps refer to.
  • Safety: hazards and precautions.
  • Troubleshooting: problems and their fixes.
  • Review notes: things in an imported document Bower thinks are worth checking.
  • Other details: anything else, as a label and a value.
You can add your own sections too, such as “Storage” or “Waste disposal”. Empty sections are hidden except in a draft.

How do I customize the sidebar?

In a draft:
  • Add a section. Click Add section at the foot of the sidebar, then pick a built-in section or Custom section….
  • Rename a custom section. Click its name.
  • Reorder sections. Drag a section by the handle on its header. With a keyboard, focus the handle, press Space, use the arrow keys, and press Space again.
  • Remove a section. Hover over its header and click ✕. Bower asks first if it has entries. Materials & equipment and Recipes can be removed only when empty.

How do versions and approval work?

When a version is ready for the bench, click Approve this version. You can give the approved state your lab’s own name.
Approval can’t be undone. The version’s values, steps and sidebar are fixed, so every run recorded against it matches what the page said at the time.
To change an approved protocol, click New version. Bower copies it into a draft, and runs keep using the approved version until you approve the new one. Lineage, at the top of the sidebar, lists every version, newest first, with where each came from (From v2, or Imported), who created it and when. It ends with the file the protocol was imported from. Click a version’s row to open it. A long history shows the newest three versions, the version runs use and the one you’re viewing, with a Show 5 earlier versions row that opens the rest in place. To delete a version, open it and click ⋮, then Delete version. You can delete a draft, or an earlier approved version nobody ran. You can’t delete a version that has runs, the version runs use, or a protocol’s only version. Version numbers aren’t reused.

Protocol runs

A run is one time someone worked through a protocol, usually hands-free with Live. Bower records which version was run, when each step was marked done or skipped, and what was captured. Anyone who can read a protocol can see its runs. Only the person who started a run can continue it.

How do I start a run?

Runs start on your phone, at the bench. Open the protocol’s version runs use and tap Execute Protocol. On a computer, that version shows Run on your phone instead: click it for a QR code that gets the Bower app, or click Use Bower in your phone’s browser instead for one that opens this protocol in your phone’s browser. Guests can see runs but can’t start one.

How do I continue a run on my phone from my computer?

Open the run on your computer and click Resume on your phone in its Summary. Scan the QR code with your phone’s camera: it opens this run in your phone’s browser, in this run’s workspace, even if your phone was in another one. Tap Execute protocol there to open Live and pick the run up where it stopped. The button shows only on a computer, on an open run, paused or in progress, that you started. The QR code holds only the run’s address, so your phone asks you to sign in if it isn’t already.

What do the run labels mean?

Each run also shows its version, such as v2, or Earlier for runs from before the protocol had versions.

Can a finished run change?

No. A Completed or Ended early run is a fixed record; start a new run to do the protocol again. There are two exceptions:

How do I see the runs of a protocol?

In the protocol library, click a protocol’s run count, such as 3 runs · 1 open, to show its runs underneath, newest first. Protocols with an open run show them already.
  • Active runs and Paused in the toolbar each list only protocols with a run in that state, and under each one show only those runs. Each shows how many runs in your workspace are in that state. Turn both on to see every run that isn’t finished. The protocol’s run count still counts every run.
  • The Protocol filter shows one protocol’s runs. View all in Protocols on a protocol’s page does the same.

How do I see when a protocol was last run?

The library’s Last run column shows the most recent run in your local time, such as Today, 09:12. For an open run, it’s the last activity. Click the column header to sort by it.

What is on a run record?

Click a run to open its record. The header shows who ran it, when, which version, how many captures and how long it took.
  • Steps lists the steps as they were run, under the protocol page’s own headings (Section A, Section B) and labels (A.1, A.2, B.1). Each shows its captures (click one to open it) and when it was marked, such as Done · 10:06:41 or Skipped · 10:07:05.
    • If Live asked for a photo or video on a step and it hadn’t reached Bower when the session ended, the step shows Photo not received or Video not received. The step’s status doesn’t change, and the line goes away if the capture arrives later.
    • A finished step shows how long it took, such as took 3 min 05 s. Once the version has at least three other completed runs, it adds the usual time, such as usually 45 s, in amber when the step took at least twice as long and a minute or more over.
    • The step’s amounts, such as 5 mL or 37 °C, show as small chips, leaving out any the step title already says. After six, the rest are counted, such as +2 more.
    • A note made on a step reads in full beside the step’s captures, oldest first: who wrote it, when, and its text. A long note is folded to a few lines, with Show more.
  • Run analysis, at the foot of the record, holds the notes about the run as a whole and the captures that belong to no step, in the order they were taken. View analysis in the Summary jumps there.
    • A note reads in place: who wrote it, when, Edited and the time if it changed later, then its text, with Show more on a long one. Images show as a count, such as 2 images; open the note to see them. Edits made elsewhere show here straight away.
    • Add a note adds your own note to the run as a whole, never to the step the run is on, in the same editor and formatting as any note. Click Add note to save it as an ordinary note linked to the run, with its own version history. It is saved in the run’s collection, like the notes from Live. An image or a table alone is enough; a note with no words is titled Note. A note added by someone other than the person who ran it shows who added it. Anyone who can edit in the workspace can add a note; guests can only read them.
    • Dictate records you; Bower transcribes it and adds the text when you stop.
    • Add images with the toolbar, the slash menu, paste or drag. They upload into the note when you click Add note. If one fails, Bower tells you and saves the note without it, so open the note to add it again. Diagrams can be added once the note is saved.
  • Steps done in the Summary counts the steps marked, such as 2 of 3 (1 skipped).
  • Transcript in the Summary opens the run’s run transcript, or reads Not saved when there isn’t one.
  • Live session in the Summary opens the Live session transcript the run was part of, when you have one.
  • Timeline lists the start, each capture, each step done, and the end, in order.
Times are in your device’s time zone; the Summary names it. A notice tells you if the protocol has changed since the run.

The run menu

A run record has a ⋮ menu at the top right of the page.

How do I print or save a run as a PDF?

  1. Open the run record.
  2. Click ⋮, then Export, then PDF.
  3. In your browser’s print dialog, print it, or choose “Save as PDF”.
The printout is laid out for paper, in the record’s order: the protocol title and run number with a link back to Bower, the Summary facts as a table, every step with its status, time, amounts, written method and captures (photos as pictures, notes as their text, a video, voice note or file by its name, linked to it in Bower; a note with pictures says how many, with a link to see them), Run analysis, and the run’s signatures. A link in a note or written method prints its address after its text, since paper can’t be clicked. It holds only what you can see on the record. A signed run’s printout is a reading copy. For the signed record itself, see Export a signed record.

Where are a run’s notes saved?

In a collection for the run, inside your workspace’s Live sessions collection, named after the protocol and run, such as Soil DNA Extraction QC · Run 4. Notes and captures from Live and notes added on the run record all go there, whoever made them. If the workspace has no Live sessions collection, or you can’t add to it, they are saved at the top level of the workspace. See Where are my Live notes and captures saved?

Runs and versions on the protocol page

At the top of a protocol’s sidebar, Runs lists up to five runs of the version you’re viewing; turn on All versions for the rest. In Lineage, a version with runs ends its second line with the count, such as 37 runs; click it to show that version’s runs here without leaving the version you’re on.

Can Bower answer questions about a protocol?

Yes. Ask Bower in the chat, for example “What are the safety notes for the PCR setup protocol?”. It reads the steps, capture steps and every sidebar section. See Bower AI assistant.

What happens when two people edit the same step?

Bower keeps both changes. A banner appears on the step: click Review to compare them, then Keep mine or Use theirs.

What if an import misses something?

When an import misses a part of your document, such as a table or the materials list, a notice at the top of the page lists what’s missing and where in the source, when Bower knows. Check those parts against your original document.

What happened to protocols written as a document?

Bower used to offer protocols written as a single note. Each one has been converted to steps, with your original text kept as Original note.md. Open it from the bottom of the protocol’s Lineage to check the steps against what you wrote.

The protocol library

The library lists every protocol in your workspace and works like the workspace’s List view. Each row shows the title, collection, versions, runs, last run, creator and last modified date. Tags and created date are in the column picker. Search, sort, and filter by collection, tag, creator or protocol. Select several protocols to act on them together.

Finding your way back

On a computer, a protocol page shows a trail such as Protocols / PCR setup, with its collection beside it. The back arrow works as it does everywhere in the workspace, and the list comes back with your search, filters and sort as you left them.

Managing and exporting a protocol

A protocol’s ⋮ menu holds a link, access, moving, favorites, version history, deleting, and export to PDF or Word. See Protocol menu and export.

Linking protocols to notes

To record which protocol a set of observations followed, link the protocol to those notes, samples or collections. A note or file captured during a run already shows where it came from, such as Run 3 · PCR setup; click it to open that run. Captures from before runs were recorded show Captured during · PCR setup and open the protocol.