The library is your permanent shelf. Unlike the temporary session, anything here is stored on your account until you delete it.
Above the shelves sits a switch: My library or one of your shared spaces. Inside a space the page looks identical to your own, so the label is what tells you where a save will land, and rows gain three extra actions: Versions, Comments and copy out. In your personal library only the copy-in action appears, and only once you belong to at least one space.
If the Research section is enabled for your account, the backtests you save there are strategies too, and they live on this same shelf: one list, sorted and searched together with the ones you imported from CSV. A backtest is not a different kind of object, it just has a different origin — so it can be added to a session, weighted, sized and saved inside a portfolio exactly like any other strategy.
You can tell them apart at a glance: a row born from a backtest carries a Backtest badge, and the toolbar gains an Origin filter (All · Imported · Backtests). Only the exception is marked; imported strategies stay unlabelled.
The numbers are the library's, not the run's
A backtest row shows the same metrics as every other row: computed by the portfolio engine from the daily series. They are not the statistics the Research run reported, which are tied to the capital and sizing of that run. If the two were mixed, sorting by Sharpe would be comparing numbers that don't mean the same thing. Promoting a backtest (below) therefore never changes its numbers.
Until you touch it, a backtest row is a projection: nothing is copied, and the backtest lives only in its Research archive. The copy is made the moment you need one — renaming it or giving it a tag promotes it to a full library strategy, which is also what unlocks versions, comments and copying into a shared space. You don't have to ask for this; it happens as you work.
From an active session, save the current portfolio under a name and, optionally, a description — a
short note on why you put this mix together, so the reasoning is still there when you come back. You can
also attach tags at this point (free labels like 0dte or live) to group and find the portfolio
later. The same Save action lives in the workspace and the status bar, and right here in the library —
on the saved-portfolios header — so you can capture the session you're working on without leaving the shelf;
it appears only when there's something to save (a fresh upload, or unsaved changes to a loaded portfolio,
where it turns into Update). You can also save an individual strategy to reuse it; strategies are tagged from the library
(see below) rather than at save time. For Option Omega strategies, the trade-level CSV is kept
alongside — for both saved strategies and saved portfolios — so they stay usable for per-strategy
dynamic sizing after you reload them.
Groups and the size knob when saving
A saved portfolio keeps groups and base weights as two separate levers, so reloading it restores both and the knob still works. A saved strategy leaves its group behind — there is no sleeve to travel with it — so its exposure is baked into the saved weight: what you reload matches what you were looking at. See Group scale.
Next to the save action, the saved-portfolios header also carries a New portfolio button. Here in the library it works differently from the one in the workspace: it uploads the CSVs you pick, asks for a name (and an optional description), and saves the result straight to the shelf as a new saved portfolio — your current working session is left untouched, and you stay in the library. Use it to stock the library from files without disturbing what you're analysing. (If any file needs an import review, load it from New session in the workspace instead, where the mapping dialog is available — see Starting a new session.)
Each saved portfolio appears as a card carrying:
Saved strategies use the same key-metrics display — the metric values you'd see on a portfolio appear on each saved strategy too (computed from its stored series on a single contract), driven by the same Metrics picker and card/list toggle. The difference is the primary action: instead of Load, a strategy offers Add (or Load, when no session is open yet) to drop it into the portfolio you're building, with a quiet status dot that turns to the accent color once it's in the active session.
Use the pencil to change a portfolio's name, description, or tags at any time — without reloading it — which is handy when you only remember why later. Saved strategies carry the same pencil for editing their name and tags. Editing metadata never touches the saved strategies or settings.
Both lists — saved portfolios and saved strategies — sit under a toolbar that filters and reorders them instantly (everything happens in the browser, with no extra loading):
The same search, sort and tag filters follow you into the Workspace: its Add and + variant menus end with Browse the library…, which opens this toolbar in a picker where you can tick several entries and bring them in together — and once your shelf grows past eight entries those menus stop listing everything, showing only what you used most recently. Tags you set here are what keep that picker fast.
Library vs. variants
Use the library to keep reusable building blocks and portfolios you'll come back to. Use variants to freeze and compare specific configurations of the session you're working on right now.