Boards

A board is a named destination for display updates. When you send an update, you specify which board it goes to, and every device connected to that board receives the content.

How boards work

• Each board has a unique board ID — a signed string you include in update requests.
• A board can have multiple devices connected to it. All of them receive the same updates.
• Each board has a layout that determines how panels are arranged on screen.
• Sending an update to a board replaces the content on the targeted panel. Other panels are unaffected.

Creating boards

You can create boards in several places:

• Mobile app — your first board is created automatically when you sign in
• Web portal — under Boards
• CLI — pushtodisplay boards create --name "My Board"
• MCP — via the pushtodisplay_create_board tool

Board ID

When you create a board, you get a board ID. This is the value you pass in the boardId field when sending updates.

If you set a default board, you can omit the boardId field entirely — updates go to your default board automatically.

Board limits

The number of boards you can create depends on your subscription tier:

See Rate Limits for the full quota table.