Skip to main content

Templates and the Org Marketplace

A workflow template is a reusable recipe. You export a workflow as a template once; anyone in your organization can install it into their own project as many times as they want, with their own credentials.

Templates are the second mental model for sharing work. The first -- direct sharing -- is covered in Sharing a Workflow. The two are different in important ways, so we'll spell out the contrast as we go.

What a template captures​

When you export a workflow as a template, the platform captures the structure:

  • The team and its agents (roles, perspectives, system prompts)
  • The stages, in order, with their hooks and routing
  • Stage assignments (which agent does what at each stage)
  • Trigger definitions (schedules, webhooks)
  • Tool assignments -- where safe to transfer (e.g. references to Skills that exist platform-wide)

A template does not capture:

  • Your credentials (API keys, secrets)
  • Your project's documents
  • Run history
  • Bindings to specific App installs

So a template is portable, but installing it requires the installer to bring their own credentials and pick which LLM configuration to use.

Exporting a workflow as a template​

Steps​

  1. Open your workflow.
  2. Click the menu in the page header and choose Export as Template.
  3. Give the template a name, description, and category. These show up in the marketplace UI when teammates browse for templates to install.
  4. Click Export. The template is created in your organization's marketplace.

# TODO screenshot: Export as Template modal with name, description, category fields

Your original workflow is unchanged. The template is an independent copy of the recipe.

Installing a template​

Steps​

  1. Open the Templates page in the sidebar.
  2. The page has two tabs: Platform (templates shipped by ORQO) and Organization (templates exported by people in your org).
  3. Click a template card to preview it. The preview shows the team, agents, stages, sample run events, and any feature tags.
  4. Click Install.
  5. Pick the target project (where the new workflow will live) and the LLM configuration (which models to use, on which credentials).
  6. Click Install to confirm.

# TODO screenshot: Template detail page with the Install button and project/LLM config selectors

A fresh workflow appears in your project, owned by you. From now on it's your workflow -- you can edit it, share it, run it, export it again, all independent from the original.

Templates vs. direct sharing -- the mental model​

This is the comparison most teams need to internalize:

Direct share (Runner / Inspector)Template
Number of copiesOne -- everyone runs the same workflowMany -- each installer has their own copy
Runs as whose credentials?The creator'sThe installer's
Recipient can edit?No (creator-only)Yes -- it's their workflow now
Recipient can re-share / re-export?Only the creator canYes -- they own their copy
Best for"Press this button for me""Here's a recipe everyone should adapt"

Direct share = delegation. "Run my workflow, on my credentials."
Template = recipe. "Here's how to do it; build your own."

If you find yourself wanting to share a workflow with five people and they each have different credentials anyway, you want a template. If you want everyone to converge on the exact same execution path with the exact same credentials, you want a direct share.

What about credentials?​

When you install a template, none of the original creator's credentials come with it. That's a deliberate safety property: secrets never cross between members.

After install, you may see warnings like:

"This workflow uses a credential 'STRIPE_API_KEY' that doesn't exist in your account. Add it under Settings → Credentials before running."

This is normal. The template references a credential by name; you supply the actual value. Add the missing credential (or rebind the workflow's stages to a credential you already have), then run.

Editing and deleting templates​

Only the creator of a template can edit or delete it -- with one exception: an admin of the organization can also edit or delete org templates, since they own infrastructure.

Editing an existing template doesn't retroactively change the workflows that were installed from it. Each installed workflow is independent from the moment of install.

Platform vs. org templates​

The Templates page has two tabs:

  • Platform templates -- shipped by ORQO and visible to every organization. You can install them but not edit them.
  • Organization templates -- exported by members of your org. Visible only to your org.

If you want a workflow that should be reusable across all ORQO customers (not just your org), that's a separate publishing flow handled through the Developer Portal -- not the regular Export.

Learn more​