> For the complete documentation index, see [llms.txt](https://captivatehelp.newbluelive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://captivatehelp.newbluelive.com/control-your-show/chapter-index-4/presets-in-companion.md). # Captivate presets in Companion Companion **Presets** are pre-configured buttons that you can drag onto a Companion page (or Stream Deck button) without manually wiring up the actions and feedbacks. The NewBlue Captivate Companion module ships a rich set of presets that mirror the actions you’d most often use during a live broadcast. ## How Captivate provides presets to Companion When the Captivate Companion module connects to a running Captivate, it asks Captivate for the current project’s preset list. Captivate generates the list dynamically from its **Automation Startup** script — so the presets you see in Companion match the project you have open. Open a different project, and a different set of presets appears. This means: * **Presets are project-specific.** A football scoreboard project will offer different presets than a news broadcast project. * **Adding or removing titles in Captivate updates Companion’s preset list automatically** — there’s no need to disconnect and reconnect. * **Each Tables Data Controller instance gets its own preset group** — projects with several Tables sources keep their buttons separated by instance, while the underlying actions and feedbacks still interoperate. * **A new project that doesn’t have an automation script yet will show very few or no presets.** ## Find Captivate’s presets in Companion 1. In Companion’s web UI, click the **Presets** tab. 2. Choose **NewBlue Captivate (Titler Live)** from the connections list on the left. 3. Categories appear — typically organized by what each set of buttons does (organized into groups like Playout, Layers, and Layer Navigation). The exact categories depend on the project you have open. 4. Click a category to see its presets. ## Use a preset 1. Open Companion’s **Buttons** tab. 2. Pick the page and button location where you want the preset to live. 3. Drag the preset from the Presets tab onto the button location. Companion fills in the button’s style, actions, and feedback. You can edit the button afterwards — change its label, color, or add additional actions to its press / release / rotate steps. The preset is just a starting point; once placed, it’s yours to customize. ## What kinds of presets ship with Captivate The exact list depends on your project, but typical categories include: * **Project navigation** — switch between projects, channels, and tabs * **Layer playback** — play, stop, and pause specific layers * **Title controls** — bring titles on and off air, with feedback that turns the button green when the title is live * **Variable manipulation** — set, toggle, or increment a title variable from a button. This is not part of the default automation script and requires a custom Companion configuration; ask your integrator if you need it. Each preset comes with its own button styling — icon, label, color — designed to be quickly identifiable on a Stream Deck or Companion page. ## Customizing the automation script The list of presets Captivate offers is defined in Captivate’s **Automation Startup** script. If you’re an advanced user, you can edit this script to add, remove, or rename presets. (See the Automation documentation for details.) After editing the script, reload the project in Captivate; Companion will receive the updated list automatically. ## When presets don’t appear If the **NewBlue Captivate** entry in Companion’s Presets tab is empty: 1. Confirm the connection’s **Status** column shows **OK** in green on the **Connections** tab. 2. Confirm Captivate has a project loaded (presets are project-specific). 3. Confirm the project’s Automation Startup script is enabled — a project without one won’t generate presets. 4. Restart the Companion connection: in the Connections tab, click the connection’s status, then **Reconnect**. ## See also * [Set up Bitfocus Companion](/control-your-show/chapter-index-4/bitfocus-companion-setup.md) — initial installation and connection * [Assign buttons for project navigation](/control-your-show/chapter-index-4/assigning-buttons-for-project-navigation.md) * [Create multi-action stacks in Companion](/control-your-show/chapter-index-4/creating-multi-action-stacks-in-companion.md) * [Operating Companion via Stream Deck](/control-your-show/chapter-index-4/operating-bitfocus-companion-via-streamdeck.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://captivatehelp.newbluelive.com/control-your-show/chapter-index-4/presets-in-companion.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.