Link UI customization

Configure how Link UI looks and which devices it offers in the dashboard. Shape the flow for a single visit with URL parameters.

App settings

Edit these in the dashboard under Link UI. Each app belongs to the environment the dashboard was switched to when you created it.

Setting
Link UI name	Shown in the header, on the consent screen, and on the Return to button. Up to 30 characters.
Logo	Square SVG, PNG, or JPG, between 48×48 and 500×500 px.
Redirect URL	Where the user goes after linking devices.
Reconnect redirect URL	Where the user goes after reconnecting.
Device types	The device types users can pick. Selecting a type offers every manufacturer available for it.
Beta manufacturers	Live apps only. Opt in to manufacturers in beta.

Add these to the Link UI URL alongside externalUserRef and sandbox.

Parameter	Values	Effect
`deviceType`	`battery`, `ev_charger`, `hvac`, `solar_inverter`, `vehicle`	Skips the device type step.
`maxDevices`	`1` to `100`	Caps how many devices the user can select. `1` makes it a single choice.
`skipDeviceSelection`	`true`	Selects every discovered device up front. The user still confirms.

https://auth.amps.ai/{appId}?externalUserRef=user_8841&deviceType=battery&maxDevices=1