> ## Documentation Index
> Fetch the complete documentation index at: https://dev.polltheroom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Put polls on slides

> Where a card goes, how it looks, and when a poll should fill the screen instead.

A poll floats on a slide as a **card**, or fills the screen as its own step. Both take the same poll; the difference is what the room looks at.

## Where a card goes

The `rect` is fractions of the slide: `x` and `y` for the top-left corner, `w` and `h` for the size. Left out, the card lands in the bottom-right quarter, the house default.

```json theme={null}
{ "x": 0.6, "y": 0.52, "w": 0.36, "h": 0.42 }
```

Three rules, from watching what looks right on a big screen:

1. Cover a screenshot, a picture or empty space. Never text.
2. If the default corner holds text, take another corner, or the picture's area.
3. A card under a fifth of the slide's height is unreadable from the back of the room.

The API refuses a card that runs off the slide. Look at the result with `get_screenshot` before handing the deck over.

## How a card looks

The `style` is the card itself: the chart variant, the accent, the background, the corner radius, shadow and outline, and what the card prints. Leave it out for the house look; send only the fields you want to change.

```json theme={null}
{ "style": { "accent": "#12B39A", "variant": "donut" } }
```

| Field                                                                          | What it does                                                                               |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| `variant`                                                                      | The chart drawn on the card: `bars`, `columns`, `donut` or `pie`. Read by multiple choice. |
| `accent`                                                                       | The card's colour.                                                                         |
| `background`                                                                   | A hex colour, or `transparent` for no card at all.                                         |
| `radius`, `shadow`, `outline`, `outlineColor`                                  | The card's edge.                                                                           |
| `showPercent`, `showCount`                                                     | Print percentages or counts beside the answers, where the widget draws them.               |
| `showJoin`                                                                     | Print the join code on the card.                                                           |
| `showTitle`, `titleFont`, `titleSize`, `titleColor`, `titleBold`, `titleAlign` | The question on the card.                                                                  |
| `textFont`                                                                     | The face for everything inside the card.                                                   |
| `colorMode`, `optionColors`                                                    | Options as shades of the accent, or as distinct hues, with a colour per option.            |

## The looks

Most widgets offer several **looks** for their result, chosen with a property on the poll: `mcStyle` for multiple choice, `scaleStyle` for a rating, `hpStyle` for 100 points, and so on. The first look is the default. Some looks need a setting: `arc` and `chord` on multiple choice draw what people picked together, so they need `multiSelect`. The [reference](/reference/document-and-widgets) lists every look per widget and the rule behind it.

## Full screen instead

A question that deserves the whole room's attention, a word cloud at the end, a Q\&A, a spin of the wheel, goes in as a poll step with `add_step`. It fills the screen when the presenter walks onto it.

```bash theme={null}
curl -X POST https://test.polltheroom.com/api/v1/decks/DECK_ID/steps \
  -H "Authorization: Bearer ptr_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "step": { "kind": "poll", "poll": { "type": "word-cloud", "prompt": "One word to take home?" } } }'
```

Any widget can float or fill the screen. A card can print percentages and counts only where the widget draws them; the reference says which.