Studio Docs

Create a Composition

Every Studio project’s Compositions page has a top-right button that creates a new composition. The button’s label changes with the active tab: + New Template on the Templates tab, + New Section on the Sections tab. Both routes end in a saved composition on the canvas, ready to author.

Do It With a Skill

No skill presses this button for you. Creating a composition is a browser action.

What an LLM can do is author the composition once it exists: build-section or build-connected-template. If you are automating the canvas itself, drive-studio-canvas-ui documents the drag-and-drop sequence that actually commits.

Where It Lives

Open your Studio project and go to Compositions. The list has two tabs, Templates and Sections, and one button in the top-right corner.

  • Templates tab: the button reads + New Template. Templates render full pages at URL patterns.
  • Sections tab: the button reads + New Section. Sections are reusable blocks with no URL of their own.

What the Button Opens

New Template

Clicking + New Template opens the Create New Template modal.

  • Connected Template (default): starts empty and connects to a Content Type you pick. Every entry of that Content Type renders at its own URL through this Template. This is the canonical use case.
  • Freeform (only when the project has Freeform enabled): a standalone Template not tied to a Content Type. Data comes in through Pinned Entries or Pinned Queries, not through URL binding.

Pick a Content Type (Connected) or accept the auto-generated URL (Freeform), name the Template, then Create. Studio saves the composition and opens the canvas ready for you to drop Sections and components.

New Section

Clicking + New Section opens a smaller modal: name the Section, click Create. Studio saves an empty Section and opens the canvas.

Once inside, wire the linked schema first (the Section canvas has a Connect A Schema guided card in the header). See Linked schema for what to pick.

What Happens After Create

  • Save persists the composition to the project. The canvas stays open for further edits.
  • Deploy publishes the composition so its rendered output goes live. See Save vs Deploy.

Nothing about creating a composition changes your app’s code. No new files, no new routes. Studio hands the spec to your app’s catch-all route at render time.