ActionsAndroid

Share button

Open the operating system share surface from a token-aware native action.

Public APILumenShareButtonAndroid / Compose

Native example

Use Share button

Use to share application-owned text, URLs, or files through the operating system. Keep content generation, file permissions, completion feedback, and error handling in the application.

Share button rendered in the Android phone emulator Lumen playground — Verified runtime captureAndroid phone emulator

LumenShareButton(
    payload = LumenSharePayload(text = reportText),
    chooserTitle = "Share report"
)

Reference

Public API

The primary shared and platform-specific options exposed by LumenShareButton.

API	Values or type	Default	Description
payload	`LumenSharePayload`	`Required`	Supplies application-owned share content.
chooserTitle	`String`	`Required`	Configures the native share presentation.
label	`Native localized text`	`Share`	Names the trigger action.
onFailure	`Platform callback`	`No-op`	Lets the application report sharing outcomes where the platform exposes them.

Native behavior

Design and accessibility

When to use it

Use to share application-owned text, URLs, or files through the operating system. Keep content generation, file permissions, completion feedback, and error handling in the application.

Accessibility

The trigger remains a native labeled button and destination selection is delegated to the operating system share surface.

Shared component

Available on other platforms

React Native Apple / SwiftUI