globe_uk 09 July 2024 • eyeglasses 5 minutes edit 10 June 2025

Supported configurations

Contents

Overview

Managed Configurations enable you to:

Enable or disable app features
Prepopulate information such as contact details or support messages
Define structured layouts using cards, grids, and kiosk elements
Configure device details visibility and theming

The full managed configuration payload can be seen here.

Core Controls

Setting	Key	Type	Default	Description
Quick actions	`enable_quick_actions`	`bool`	`true`	Enables call, email, map, and web buttons using values from `contact_info`.
Organisation message	`enable_org_message`	`bool`	`true`	Displays the organisation message.
Organisation message text	`org_message`	`string`	This is a default message set via managed config. Edit the configuration to adjust this text. HTML supported.	Rich HTML content with basic markdown-like formatting. Supports links and inline images.
Contact details	`enable_contact_details`	`bool`	`true`	Displays static contact card using values from `contact_info`.
Device details	`enable_device_details`	`bool`	`true`	Enables the device details card.

Contact Info

Setting	Key	Type	Default	Description
Contact phone	`contact_phone`	`string`	`+445566778899`	Phone number used by the call quick action.
Contact email	`contact_email`	`string`	`project-support@bayton.org`	Email used by the email quick action.
Contact website	`contact_website`	`string`	`https://bayton.org/projects`	Website URL used by the web quick action.
Contact address	`contact_address`	`string`	`Newport, Wales`	Address used by the map quick action.

Quick Action Settings

Setting	Key	Type	Default	Description
Call action	`enable_call`	`bool`	`true`	Toggle visibility of the call action.
Email action	`enable_email`	`bool`	`true`	Toggle visibility of the email action.
Web action	`enable_web`	`bool`	`true`	Toggle visibility of the web action.
Map action	`enable_map`	`bool`	`true`	Toggle visibility of the map action.

Device Details Settings

Setting	Key	Type	Default	Description
Basic info	`device_details_enable_basic`	`bool`	`true`	Basic info: model, OS, uptime.
Software details	`device_details_enable_software`	`bool`	`true`	Shows software details (build info).
Hardware features	`device_details_enable_hardware`	`bool`	`true`	Shows hardware features.
Connectivity radios	`device_details_enable_radio`	`bool`	`true`	Shows connectivity radios.
Network details	`device_details_enable_network`	`bool`	`true`	Shows active network details.

Customisation Settings

Setting	Key	Type	Default	Description
Organisation ID	`organisation_id`	`string`	-	Used for licensing and organisation-specific data.
Custom app title	`custom_app_title`	`string`	`"Info"`	Title shown in app.
Device identifiers	`enable_device_identifiers`	`bool`	`false`	Enables display of device identifiers.
Device details button	`enable_device_details_button`	`bool`	`false`	Adds a quick access button to open device details.
Enable settings	`enable_settings`	`bool`	`true`	Enables the settings page.
Allow fun	`allow_fun`	`bool`	`true`	Enables optional fun elements (e.g., Baydroid).
Show missing packages	`show_missing_packages`	`bool`	`true`	If `false`, hides invalid apps instead of showing error cards.

Set Order

Setting	Key	Type	Default	Description
Quick actions order	`set_order_quick_actions`	`int`	`1`	Order index of the Quick Actions card.
Organisation message order	`set_order_org_message`	`int`	`2`	Order index of the Org Message card.
Contact details order	`set_order_contact_details`	`int`	`3`	Order index of the Contact Details card.
Device info order	`set_order_device_information`	`int`	`5`	Order index of the Device Info card.

Kiosk Settings

Setting	Key	Type	Default	Description
Top bar	`kiosk_enable_top_bar`	`bool`	`true`	Shows/hides the top bar in kiosk mode.
Managed settings shortcut	`kiosk_enable_managed_settings`	`bool`	`false`	Enables a shortcut to Managed Settings.
Theme override	`kiosk_override_theme`	`choice`	`"automatic"`	Forces light or dark mode override.
Background image	`kiosk_custom_background_image`	`string`	-	URI to a background image.
Background colour	`kiosk_custom_background_colour`	`string`	-	Background fallback colour.
Card colour	`kiosk_custom_card_colour`	`string`	-	Background colour for cards.
Text colour	`kiosk_custom_text_colour`	`string`	-	Text colour override.
Background text colour	`kiosk_custom_background_text_colour`	`string`	-	Text colour over background images.
Background grid card transparency	`kiosk_custom_background_grid_card_transparency`	`bool`	`false`	Applies transparency as a boolean (on/off) to multi-app cards.
Background card text transparency	`kiosk_custom_background_card_with_text_transparency`	`int`	`10`	Transparency (0–10) for text cards.
Launcher enabled	`kiosk_enable_launcher`	`bool`	`false`	Enables full launcher functionality.
Admin override	`kiosk_enable_admin_override`	`bool`	`false`	Enables escape mechanism for admins.
Admin password	`kiosk_admin_password`	`string`	-	Password required for admin override.

Combined Card Stacks

card_stacks is a bundle_array defining the UI layout.

Each stack (stack_bundle) may contain:

stack_cards: markdown or HTML message cards
stack_multi_app_card: grids of apps (or blocklisted apps)
stack_single_app_card: single app with a label and message
stack_heading: section headings

Stack Configuration

Setting	Key	Type	Default	Description
Stack ID	`stack_id`	`string`	-	Optional identifier for the stack. Can be used to reference a specific stack in configs or diagnostics.
Stack orientation	`stack_orientation`	`choice`	`vertical`	Controls the layout direction for cards within the stack. Valid values: `vertical`, `horizontal`.
Stack order	`stack_order`	`int`	`4`	Position of the stack in the rendered layout. Lower = higher.
Enable stack	`enable_stack`	`bool`	`true`	Whether the stack should be shown.

Multi-App Card

Setting	Key	Type	Default	Description
Multi-app card title	`stack_multi_app_card_title`	`string`	App grid title	Title for the card
Package names	`stack_multi_app_card_package_names`	`string`	`com.android.chrome, org.bayton.packagesearch`	Comma-separated list of package names or URLs
Card order	`stack_multi_app_card_order`	`int`	`0`	Order of the card in the stack
Grid columns	`stack_multi_app_card_grid_columns`	`int`	`0`	Grid column count, `0` = auto
Blocklist mode	`stack_multi_app_card_blocklist`	`bool`	false	If `true`, this card will display all apps EXCEPT those listed
Enable multi-app card	`enable_multi_app_stack_card`	`bool`	`false`	Enables this multi-app grid card in the stack.

Single App Card

Setting	Key	Type	Default	Description
Single app card title	`stack_single_app_card_title`	`string`	`App card title`	Title for the card
Package name	`stack_single_app_card_package_name`	`string`	`com.android.chrome`	Package name of the app
Message	`stack_single_app_card_message`	`string`	`Add a description to accompany this standalone application.`	Optional supporting text
Card order	`stack_single_app_card_order`	`int`	`0`	Order of the card in the stack
Enable app card	`enable_single_app_stack_card`	`bool`	`false`	Enables this single app card within the stack.

Text Card

Setting	Key	Type	Default	Description
Text card title	`stack_card_title`	`string`	Stack card title	Title for the card
Message text	`stack_card_message`	`string`	This is a default message set via managed config. Edit the configuration to adjust this text. HTML supported.	Message text (HTML supported)
Card order	`stack_card_order`	`int`	`0`	Card ordering in the stack
Enable text card	`enable_stack_card`	`bool`	`false`	Enables or disables display of this text card.

YouTube Card #soon

Setting	Key	Type	Default	Description
Video embed title	`stack_video_embed_card_title`	`string`	`Video card title`	Optional title
Video URL	`stack_video_embed_card_url`	`string`		YouTube video URL
Card order	`stack_video_embed_card_order`	`int`	`0`	Order of card

Heading Card

Setting	Key	Type	Default	Description
Heading title	`stack_heading_title`	`string`	Heading title	Section heading
Title size	`stack_heading_title_size`	`string`	`Default`	Size (e.g. `Default`, `XL`, `XXL`)
Enable heading card	`enable_stack_heading`	`bool`	`false`	Enables this heading card section.

Limitations

Apps must be installed for icons/names to appear.
HTML and Markdown rendering is basic (e.g., no tables/lists).
Blocklist mode works only in multi-app cards. #soon
Embedded videos and web URLs require network access.

Further support or feature requests

Are you in need of further help, or would you like to raise a feature request? You can:

Submit feedback
Raise a feature request on GitHub
Join the BAYTON Discord
Tag me on LinkedIn