Demos are recorded on a desktop screen, which is too small to read when a phone shrinks it to fit. So phones get a layout made for them. You choose it per demo, and it works for the hosted page, embeds, share links and collections.
Every plan has the phone layout, stories and the full-screen option for embeds.
Choose how phones show a demo
- Open the demo and click the Share tab.
- Under On phones, pick one:
- Phone layout (the default): the screen fills the phone at a size you can read and moves to each step’s highlight. The step’s text sits in a sheet at the bottom, with Back and Next buttons in reach of a thumb. On a phone held sideways the text moves to a panel on the right.
- Stories: each step becomes a full-screen card, like stories in social apps: the screen around the step’s highlight, the step’s text, and progress bars on top. Viewers tap the right side of a card (or swipe left) to go on and the left side (or swipe right) to go back. The last card shows your call to action.
- As on desktop: the desktop player, scaled down to the phone.
The change is live at once, for every link and embed. You don’t need to publish again.
Stories are built from your steps automatically. There is nothing extra to write. Clickable demos become stories that follow the path you recorded: one card per screen, pointing at the hotspot that leads on.
Preview it on a phone
Click Preview on a phone next to On phones. The draft plays in a phone-sized frame. Switch between Phone layout and Stories, and click On its side to see the phone held sideways. Nothing in the preview is recorded.
What viewers can do in the phone layout
- Tap the highlight or Next to go on. Every step that waits for a click also has Next on phones, so a small target never gets in the way.
- Drag the screen to look around it. The next step brings it back to its highlight.
- Show the whole screen with the magnifier button in the top corner, and tap it again to zoom back in.
- Clickable demos start on the hotspot to try first, show every hotspot without hovering, and say Tap here on the suggested one.
The phone layout follows the space the demo has, not the device. A demo that has the whole screen (the hosted page, a full-screen embed) or a tall frame gets it. A small, wide embed inside an article keeps the desktop player, unless you turn on Open full screen on phones (below).
Open embeds full screen on phones
An embed in a blog post or help article is usually a short, wide frame: on a phone that’s a strip a few centimeters tall. To give phone viewers the whole screen instead:
- In the Share tab, click Embed.
- Turn on Open full screen on phones.
On a phone, the embed then shows a poster with your demo’s first screen, its title and a play button. Tapping it opens the demo full screen. Where the browser can’t make a page full screen (Safari on iPhone), it opens the demo’s hosted page in a new tab instead. Computers and tablets still play the demo inside the frame.
With the option off, a small embed still plays in its frame, and phone viewers get a Full screen button in the control bar that does the same thing.
Small frames
When a frame is short, your call-to-action button and the checklist button move into the control bar, so the screen keeps its room. With little width, the call-to-action button shows its icon only (its text shows on hover and is read by screen readers). In full screen, or in a bigger frame, they go back under the screen.
You can also set these per embed, in the src address: phone=layout, phone=stories or phone=desktop, and fullscreen=1 or fullscreen=0. See Embed a demo.
In your analytics
Steps, completions and clicks on your call to action count the same whichever way a viewer saw the demo. The demo’s Analytics tab shows How it was seen: the share of sessions on the desktop player, the phone layout and stories.
Troubleshooting
- A phone shows the desktop player. The demo is set to As on desktop, or it’s embedded in a small frame. Turn on Open full screen on phones, or make the frame taller on phones.
- Stories show the phone layout on a computer. Stories are for phones. Computers and tablets get the phone layout in a narrow frame and the desktop player otherwise. Use Preview on a phone to see the stories.
- An embed opened in a new tab on an iPhone. That’s expected: Safari on iPhone doesn’t let a page inside another page go full screen.