# 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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digia.tech/logic-and-interaction/actions/share.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.