> For the complete documentation index, see [llms.txt](https://docs.digia.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digia.tech/logic-and-interaction/actions/share.md).

# Share

{% embed url="<https://youtu.be/jttokrug3xY?si=BjVu4u5AbDu0O8XS>" %}

Watch this on Youtube: <https://www.youtube.com/watch?v=jttokrug3xY>

The **Share** action allows you to trigger the device's native share dialog, enabling users to share text-based content through installed apps such as messaging, email, or social media platforms.

***

#### 📦 Properties

| Property  | Type                | Required | Description                                      |
| --------- | ------------------- | -------- | ------------------------------------------------ |
| `message` | Expression (String) | ✅        | The text content to share                        |
| `subject` | Expression (String) | ❌        | Subject line (used by email and some other apps) |

***

#### 📱 Platform Behavior

| Platform                 | Behavior                                               |
| ------------------------ | ------------------------------------------------------ |
| **Mobile (iOS/Android)** | Opens native share sheet with available apps           |
| **Web**                  | Shows dialog explaining feature requires mobile device |
| **Desktop**              | Uses system share functionality where available        |

***

#### ✅ Common Use Cases

* Sharing referral codes, promo codes, or invite links
* Allowing users to share app content or achievements
* Promoting user-generated content through social channels
* Sharing contact information or business details
* Distributing links to articles, products, or resources

***

#### ⚙️ Default Behavior

By default:

| Behavior               | Description                                               |
| ---------------------- | --------------------------------------------------------- |
| **Platform Support**   | Uses native share sheet on mobile devices                 |
| **Web Behavior**       | Shows informational dialog (sharing not supported on web) |
| **Content Validation** | Requires non-empty message to proceed                     |
| **App Selection**      | User chooses destination app from available options       |

***

#### 🛠️ How to Use

<figure><img src="/files/JoY6HVqsVFuRjn3XNfD8" alt="Copy Slugs"><figcaption><p>Copy Slug</p></figcaption></figure>

1. Add the action to a widget event (e.g., share button, social media icon)
2. Choose **Share** from the action list
3. Set the `message` property with the content to share
4. Optionally add a `subject` for email sharing

***