# Email Social Share ❺

Designed to make a link element work as a sharing mechanism for the current page.

When clicked, it invokes the user's defined email program to send a message, and populates the subject and body, including the link to the current page.

The user then enters to To, and sends it. 

## Demonstration

{% embed url="<https://webflow.com/made-in-webflow/website/sa5-social-share>" %}

## Getting Started  <a href="#step-1---add-the-library" id="step-1---add-the-library"></a>

### STEP 1 - Add the Library  <a href="#step-1---add-the-library" id="step-1---add-the-library"></a>

First, **add the library** as detailed in [Quick Start](/sa5-socialshare/quick-start.md).&#x20;

### STEP 2 - Apply `wfu-socialshare` to Desired Elements <a href="#step-2---apply-wfu-query-param-to-desired-elements" id="step-2---apply-wfu-query-param-to-desired-elements"></a>

See Usage Notes for details.&#x20;

## Usage Notes

### `wfu-socialshare` = `email`

**Required.**  Place directly on the link that you want to use for social sharing.&#x20;

{% hint style="warning" %}
This will replace any existing `src` on the link with the `mailto:` URL SA5 forms for you.&#x20;
{% endhint %}

### `wfu-socialshare-subject` = ( subject text you want on the email )

**Optional.** Place on the element with `wfu-socialshare`. &#x20;

### `wfu-socialshare-message` = message you want to preface the link

**Optional.** Place on the element with `wfu-socialshare`. &#x20;

Note the message can contain line-breaks, by using the `\n` character sequence.&#x20;

### UTM Tracking

If you want to add tracking information to the link, you can use SA5's UTM Tracking attributes here as well, on this same email element.&#x20;

[UTM Tracking](/sa5-analytics/utm-tracking.md)

In general, we'd recommend something like;&#x20;

<table><thead><tr><th width="272">SA5 attribute</th><th>Example Value</th><th>Notes</th></tr></thead><tbody><tr><td><code>wfu-link-utm-source</code></td><td><code>email</code></td><td></td></tr><tr><td><code>wfu-link-utm-medium</code></td><td><code>share</code></td><td>Indicates that it was shared</td></tr><tr><td><code>wfu-link-utm-campaign</code></td><td><code>blog</code></td><td>Or similar ( news, recipe... )</td></tr><tr><td><code>wfu-link-utm-content</code></td><td>Your Article Title</td><td>CMS-bind this one if you're in a collection list or collection page. </td></tr></tbody></table>


---

# 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://attr.sygnal.com/sa5-socialshare/cache.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.