n8n

The official Push To Display community node for n8n lets you send display updates from any workflow — dashboards, signage, and status boards update instantly across every device linked to the board.

The node is published to npm as n8n-nodes-pushtodisplay. It exposes a single Send Update operation backed by the HTTP API.

Installation

From the n8n UI (recommended)

In n8n, go to Settings → Community nodes → Install a community node.
Search for n8n-nodes-pushtodisplay and install it.

Self-hosted n8n

npm install -g n8n-nodes-pushtodisplay

Then restart n8n. The node appears in the node panel as PushToDisplay.

Credentials

The node supports two authentication methods. Choose one when you connect the node to a credential.

API Key

The simplest option for automation. API keys start with pt_ and are created in the web portal under API Keys (or from the Quick Start screen in the mobile app).

Create an API key in the portal.
In n8n, create a PushToDisplay API credential and paste the key.
Select API Key in the node's Authentication field.

API key values are only shown once when created. If you lose a key, revoke it and create a new one. Never commit keys to version control.

OAuth2

Connects with your Push To Display account. Scopes are fixed to openid and push, and the app can only be used by the account that created it.

In n8n, create a PushToDisplay OAuth2 API credential and copy the OAuth Redirect URL shown in the form (e.g. https://app.n8n.cloud/rest/oauth2-credential/callback). Leave the client ID and secret empty for now.
In the web portal, go to OAuth Apps → n8n Node App and paste the redirect URL into the OAuth redirect URI field.
Click Create n8n app, then copy the Client ID and Client Secret — they are shown only once.
Paste the client ID and secret into the n8n credential.
Click Connect and sign in with your account.
Select OAuth2 in the node's Authentication field.

Send an update

Add the PushToDisplay node to your workflow.
Connect a credential (see above).
Set the Board ID — find it in the Push To Display app or web portal. Leave blank to use your default board.
Enter the Message text to display.
Configure styling and layout as needed (see the field reference below).
Run the workflow. The update is queued and pushed to every device linked to the board.

Field reference

Node field	API field	Description
Board ID	`boardId`	The board to update. Uses your default board if omitted.
Message	`blocks`	The text to display on the board.
Target Panel	`panelId`	Which panel to update (1–4). Defaults to panel 1.
Text Color	`blocks[].color`	Message text color in hex (`#RRGGBB`).
Text Size	`blocks[].size`	Text size: `small`, `medium`, or `large`.
Font Weight	`blocks[].weight`	Text weight: `regular`, `semibold`, or `bold`.
Horizontal Alignment	`alignX`	Horizontal alignment: `start`, `center`, or `end`.
Vertical Alignment	`alignY`	Vertical alignment: `start`, `center`, or `end`.
Full Panel Mode	`fullPanel`	When enabled, content fills the entire panel area.
Content Spacing	`density`	Line spacing: `compact`, `standard`, or `spacious`.
Text Background Color	`blocks[].background`	Highlight color directly behind the text (`#RRGGBB`).
Background Color	`background`	Panel background color (`#RRGGBB`).

Limits

Your free Sandbox tier includes 1 board and 1,000 messages per month. See Rate limits and quotas for details.

See n8n Examples for copy-paste workflow recipes.

n8n