> 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/design-and-customize-graphics/chapter-index-5/roll-conductor.md).
# Roll Conductor
A Roll Conductor turns one designed item — a credit line, a name and title, a roster entry — into a vertically scrolling stream of items, each fed by a connected data source. Items roll up the screen (or down, if you reverse direction), and the conductor asks the data source for the next row as the queue drains.
A Roll Conductor is the vertical-axis sibling of the [Crawl Conductor](/design-and-customize-graphics/chapter-index-5/crawl-conductor.md). It shares the same item-pool mechanics; only the scroll axis differs.
## Designer Setup
You build a Roll Conductor by wrapping one designed item (a group of layers) in a conductor. The conductor then rolls a stream of cloned items vertically, asking your data source for new content as it goes.
1. In Captivate’s playout interface, select the graphic in the Project List, then click the **Edit Graphic** button in the Preview panel to open the Designer.
2. Build **one item** — for example, a row of credits with a name on the left and a role on the right, or a vertical strip with a logo and a headline. Arrange the layers as the item should look as it rolls by.
3. Select all the layers that make up the item, right-click in the canvas (or in the Timeline panel) and choose **Create Conductor** > **Roll**. This combines the layers into one group and embeds the group in a Roll Conductor.
If the **Create Conductor** menu is missing, your license doesn’t include the Roll conductor; check your entitlements with NewBlue support.
4. Click on the conductor in the canvas to select it. The Properties panel’s **Conductor** tab shows the conductor’s design-time settings — speed, spacing, direction, and more.
{% hint style="info" %}
The conductor’s item template is the group you wrapped. Edit anything in that group and every rolled item picks up the change.
{% endhint %}
When the conductor is built, commit your changes with the green checkmark and return to the playout interface. You connect the data source there, not in the Designer — see [Drive a graphic with Tables: Row](/play-and-update-graphics/chapter-index-1/drive-a-graphic-with-tables-row.md).
## Properties
A Roll Conductor’s settings appear in two places:
* **In the Designer**, when you select the Roll Conductor instance inside the title, the Properties panel shows a **Conductor** tab with **all** settings — including design-time-only fields like spacing, animation, and clipping that don’t appear at playout time.
* **In the playout main view**, when you select the title that contains the Roll Conductor, the title’s Properties shows a **Roll** tab with the runtime-tunable subset (speed, reverse direction, repeat behavior, motion blur).
Fields marked *(Designer only)* below appear only in the Designer view.
### Name
The name your data source uses to address the conductor. The default is **Roll**. If you rename it to, for example, **Credits**, your data source must address conductor parameters as `Credits.Speed` instead of `Roll.Speed`. Item variable names (the columns in your data) are not affected by the conductor name.
Give each conductor a unique name when a graphic holds more than one of the same type — that’s how their data and parameters stay separate. You set the name here in the Designer; in the playout Properties it’s read-only.
### Speed
Roll velocity. Default **10.00**. Range **0**–**100.00**, step **0.10**. **Higher values are faster** — 10 is slow, 100 is very fast.
### Reverse
When on, the roll moves top-to-bottom instead of the default bottom-to-top. Default **off**.
The default direction is bottom-to-top, the conventional credits direction.
### Spacing *(Designer only)*
Distance between consecutive roll items, expressed as a fraction of the project frame’s height. Default **0.05** (5% of height). Range **-0.05** to **1.00**, step **0.05**.
Negative values let consecutive items overlap by up to 5% of the height.
### Animate In *(Designer only)*
When on, each roll item plays its in-animation as it first enters. Default **off**.
### Animate Out *(Designer only)*
When on, each roll item plays its out-animation as it leaves. Default **off**.
### Clip to Bounds *(Designer only)*
When on, the roll is clipped to the conductor’s bounding box. Default **off**. Items outside the box are not drawn.
### Repeat Last Item
When on, the roll re-uses the most recent item value if the data source has nothing new to send — useful for keeping a roll cycling on the same final row. When off, the roll pauses and waits for fresh content.
Default **off**. (Note: this is the opposite of the Crawl Conductor’s default — a roll has a sense of completion that a crawl doesn’t.) Turn on when you want the last row to keep cycling.
### Motion Blur Aperture
Shutter angle in degrees applied to the roll’s motion blur. Default **180** (cinema standard). Range **0**–**360**, step **1**.
* **0** — no motion blur
* **180** — cinema standard
* **360** — maximum blur
Motion blur only renders when **Motion Blur Quality** is greater than 0.
### Motion Blur Quality
Iteration count for the motion-blur sampler. Default **0** (off). Range **0**–**6**, step **1**.
Higher values produce smoother blur at higher render cost. Leave at 0 unless the roll is fast enough to show stepping.
## See also
* [Drive a graphic with Tables: Row](/play-and-update-graphics/chapter-index-1/drive-a-graphic-with-tables-row.md) — the most common data source for a Roll Conductor.
* [Crawls Controller](/play-and-update-graphics/chapter-index-1/crawls-controller.md) — General-menu variant of the same controller.
* [Crawl Conductor](/design-and-customize-graphics/chapter-index-5/crawl-conductor.md) — the horizontal-axis sibling
* [Leaderboard Conductor](/design-and-customize-graphics/chapter-index-5/leaderboard-conductor.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/design-and-customize-graphics/chapter-index-5/roll-conductor.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.
