The show and the screen are different shapes

When it goes wrong Lesson 4 of 4 about 5 minutes

The board is upright, readable and sitting in a band across the middle with black above and below it. Nothing is broken. The bars tell you which of the two shapes is wrong, and there are exactly two ways out: turn the screen, or rebuild the show.

C By The ChannelOS team
The ChannelOS channels list in the operator app, each channel showing its shape beside its name

The short version, in 5 steps

  1. Stand in front of the panel and note which way the black bars run: down the two sides, or across the top and bottom.
  2. Read the bars: at the sides means a portrait show in a landscape frame, top and bottom means a landscape show in a portrait frame.
  3. Decide which half is wrong: the panel for the wall, or the show for the content.
  4. If only the panel is turned the wrong way, set the screen's rotation under Screens and How it is mounted.
  5. If the panel is right and the show was built for the other shape, open the show and change Shape of this show, then review every slide.

You built the menu board for the counter screen last month and it has been fine. Now there is a second screen, a tall one on a pillar by the door, and you have pointed it at the same show. The board has come up upright and readable, in a band across the middle, with a thick black stripe above it and another below.

Nothing is cut off and nothing is squashed. It is simply using about a third of a panel you paid to hang.

A show has a shape and a panel has a frame, and when the two disagree the show is fitted inside the frame rather than stretched or cropped. Digital signage shapes are 16:9 landscape and 9:16 portrait, chosen when the show is made. The leftover space is the black bars, and which way those bars run tells you which half of the pair is wrong.

Which way do the bars run?

One glance from in front of the panel answers it.

What you see on the panelWhat it meansThe frame it is in
Black bars down the left and right, board is a narrow columnA portrait show (9:16)A landscape frame
Black bars across the top and bottom, board is a wide bandA landscape show (16:9)A portrait frame
No bars, edge to edgeThe shapes matchNothing to fix

The app uses those same two phrases, Bars at the sides and Bars top and bottom, marked against each screen in the publish and tune pickers, so the wall and the app agree.

One symptom looks related and is not. A board lying on its side, with headings running up the wall, or one that is the right way round but upside down, is the screen’s rotation rather than a shape mismatch, and it has its own four-way diagnosis in which of the four settings is wrong. A shape mismatch always produces an upright, readable board, so if you can read it comfortably and it is merely small, you are in the right lesson. What the mismatch costs in actual pixels, for every mount and shape pairing, is tabulated in the digital signage size guide.

Why does it not just stretch to fit?

Because both alternatives are worse than bars.

Stretching distorts everything it touches. A logo goes oval, a face goes wide, and a price that was set at a careful weight comes out condensed. Cropping means software deciding which third of your board to throw away, and it has no way of knowing that the third it dropped was the prices.

So a mismatch is allowed to be ugly rather than wrong: it costs you screen area and never the board. A landscape menu on a portrait pillar is a correct menu that is too small, which is a fair decision for a week while you build the right one.

Should I turn the screen, or change the show?

One question picks the exit, and it is not about software.

Is the content right for the way the panel is hung? A menu of five priced lines read from four metres suits a tall frame. A two-column timetable or a wide photograph does not. Answer that, and the fix follows:

Get this the wrong way round and you do an afternoon of design work to solve a problem that was a wall bracket.

How do I rotate the screen instead?

The cheap exit, and it applies if the TV is already turned, or you are willing to turn it.

  1. Open Screens and pick the screen.
  2. On its Device card, find How it is mounted.
  3. Choose the quarter turn that matches the TV’s top edge as it hangs now.

Rotation changes the frame the player draws into and never touches a slide, so no work is at risk. It reaches the player in a few seconds, with no remote and no walk over to the set.

The limit is physical. If the TV is bolted up the normal way and the show is portrait, changing this setting gives you a sideways picture rather than a fitted one, because the frame follows the panel and the mount setting together.

How do I change the show’s shape?

The real exit, and it is work. Be honest about that before you start.

  1. Open the show in the editor and find the shape badge in the top bar. It reads Landscape (16:9) or Portrait (9:16).
  2. Click it. The menu is headed Shape of this show and lists both.
  3. Pick the other one. For a shape this deck has never been, the row says it will build it from this deck and then leave you to fix it up.
  4. Go through every slide. The toast is explicit: everything moved to fit the new shape, so check each slide before you publish.

On a phone that badge lives in the editor’s wide layout, so use Make a portrait version from the show’s menu on Shows instead: the same pass, forked into a second show.

What the pass actually does is re-compose rather than rotate: it rescales the type so it keeps its apparent size, re-places the boxes into a vertical stack, then separates anything that ends up overlapping. It has to re-compose because positions convert for free while type sizes, being a percentage of the slide’s width, do not. The detail of composing for the narrow shape, and the type sizes it actually needs, is building a show designed for portrait.

The shape you leave is parked, not overwritten: the picker says your other shape is kept and switching back returns it exactly as you left it, so the first flip is the only expensive one. A show on air keeps playing throughout, with the confirmation naming the screens or channels involved first.

When is neither fix the right answer?

When one deck has to fill both shapes by itself. There are no per-screen layout variants here: a show is authored in one shape, and every screen airing it gets that shape fitted into its own frame. A mixed estate means two shows, kept in step by hand. If that is the job, buy a platform built around responsive per-screen layouts, where one deck carries a layout per panel shape and the player picks. That is a real reason to look elsewhere.

The reflow is a draft, not a board. Expect to cut lines rather than nudge them, because a narrower frame holds fewer items at a size anyone can read. Treat that as a rule of thumb and check it against your own deck.

Neither control fixes the other’s fault. Rotating a screen cannot make a landscape deck fill a portrait panel, and changing a show’s shape cannot right a sideways mount.

How do you avoid this next time?

Three habits, cheapest first.

Answer the shape when the show is created. A brand new show asks Shape of this show on the empty board and will not let you add anything until you answer, then Start building. On an empty deck there is nothing to re-place, so the choice is free.

If you need both, keep them as two shows. Make a portrait version forks a copy and leaves the original alone, so each is designed for its own panel and neither is a compromise flipped back and forth.

Start from a template. The templates gallery carries official boards in both shapes, and each board’s page names the shape it was authored at, so you can begin from one already built for the way your panel hangs.

Go and look at the panel, note which way the bars run, and change the one setting it points at. On a free screen a ChannelOS banner sits along the bottom and about every two minutes opens into a full ChannelOS slide for roughly 30 seconds, naming what ChannelOS is and the channelos.tv address, then folds back. Any paid plan removes both. The black bars are not part of that: they are geometry, and they go when the shapes agree.

Frequently asked questions

What aspect ratio is digital signage?
Two shapes cover almost all of it. 16:9 landscape, which is 1920 by 1080 on a normal 1080p television, and 9:16 portrait, which is the same panel turned a quarter round at 1080 by 1920. In ChannelOS a show is built at one of those two and carries it, so the question is a shape rather than a pixel count. The panel's own resolution is the panel's business, and a 4K screen draws the same show at its own resolution.
Why is my digital sign letterboxed?
Because the show's shape and the frame it is being drawn into do not match, so the board is fitted inside the frame with bars filling what is left over. The frame comes from the panel plus the rotation set against that screen, and the shape comes from the show. Nothing is cropped and nothing is stretched, which is why the board still reads correctly. You are losing screen area, not content.
Can I use a 16:9 show on a portrait screen?
Yes, and it plays correctly. On a turned 1080p panel a landscape show draws at 1080 by 608 with black bars above and below: upright, undistorted, and covering roughly a third of the glass. Nothing is cropped, but the board is drawn 1080 wide where a landscape panel would give it 1920, so the type is a little over half the height it was composed at and the distance it stays readable from shrinks with it. Nothing blocks you either: the publish and tune pickers list the shape-matched screens first and mark the others, and the mark is advice rather than a block. A reasonable stopgap, a poor permanent answer for a screen you paid to hang.
How do I change a show from landscape to portrait?
Open the show in the editor and click the shape badge in the top bar, which reads Landscape (16:9) or Portrait (9:16). The menu is headed Shape of this show. Picking the other shape rescales the type to keep its apparent size, re-places the boxes into a vertical stack, and separates anything that collides. What comes back is a draft you finish, so go through each slide before you publish it.
Does changing the shape destroy the layout I already built?
No. The shape you leave is parked rather than overwritten, and the picker says so under the two options: your other shape is kept, and switching back returns it exactly as you left it. That makes the first flip the only expensive one. If you would rather keep both as separate shows, use Make a portrait version from the show's menu on Shows, which forks a copy and leaves the original untouched and airing.
Can one show fill both a portrait and a landscape screen?
Not automatically. ChannelOS does not swap in a shape-matched layout per screen. One show is authored in one shape, and every screen airing it gets that shape fitted into whatever frame its panel and rotation produce. A mixed fleet means two shows, one per shape. If every board must fill every panel by itself, a platform built around per-screen layout variants is the better purchase.

Further reading

Do it on a real screen.

Open the player on the TV, scan the code with your phone, and publish a show. Your first screen is free.

Free screens show a ChannelOS banner, and about every 2 minutes it opens into a full ChannelOS slide; any paid plan removes both.

Related lessons

Sell it instead of buying it. The ChannelOS partner program pays 20% of what each business you refer pays us for their first 12 months, then 10% for as long as they stay. Free to join, nothing to stock.

See the partner program →