Skip to Content
PlatformHow-to guidesSwitch programs

How to switch programs

Use this guide when you belong to more than one program, or when you land in the wrong one. You start in any program page; you end in the program you meant, with the app remembering it for next time. Seeing a program in the switcher needs any program-scope permission in it (the /me response lists the programs you can open); the organisation pages need the matching org.*.read permission.

Prerequisites

  • Access to at least two programs, for example default and trv-101 after the illustrative seed.

Open the switcher

In the topbar choose the program name (the control is labelled “Switch program”). A list titled Programs opens with every program your /me response returned, each with its current stage.

Choose a program

Select the program. The app opens the same area and section in the chosen program (any selected record is dropped), or that program’s home page /p/<slug>/home when you were on Home, and writes the last_program cookie (path /, 180 days, SameSite=Lax) so the next visit to / resolves to this program.

Return through a short URL

Typing /p/<slug> in the address bar redirects with 308 to /p/<slug>/home, query string preserved. Typing / runs the resolver: /me, then the last_program cookie, then the first program in the list.

Go to the organisation

Choose Organization at the foot of the rail. It opens /org/settings; /org on its own redirects there with 308. The panel lists Settings, Programs, Users, Groups, Roles and Audit, each shown only with its org.*.read permission; program owners without an organisation persona see none of them.

Manage which programs exist

Under Organization › Programs (/org/programs, needs org.programs.read) an administrator creates a program (org.programs.create) or renames, pauses, completes or archives one (org.programs.manage). Every new organisation starts with the program default.

Troubleshooting

SymptomCauseFix
A program is missing from the switcherYou hold no program-scope permission in itAsk a program owner for a persona such as viewer
/ keeps opening the same programThe last_program cookie points at itSwitch once; the cookie follows
“Program not found” pageThe slug in the URL does not match a program you can openUse the switcher or check the slug (^[a-z0-9][a-z0-9-]{0,63}$)
Request an approvalProducts