> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.metalocator.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Unified Share Control

The Unified Share control presents a combined modal window which allows end users to share the location they are viewing via multiple platforms and media.

To add the Unified Share control to the results, click Results, expand the List, and click Add Field and add Unified Share as shown.

[![](https://storage.crisp.chat/users/helpdesk/website/-/e/9/6/e/e96e81afa37d3800/9c92f026-a84a-4476-9910-3531eb_1naox5d.png)](https://downloads.intercomcdn.com/i/o/479087254/38c7b881e165682190c470fe/image.png?expires=1794512700&signature=53d08eb68f9a25f44b1c704b36ae3cc9d4b3bb6d30da8124618ebdeebf8a3296&req=cCcuFsF5n4RbFb4f3HP0gJVf5fCA2iU%2BU%2FVfdPb2wHyqBikkLZpR8AN%2B616M%0ANFQTZMEqgc5jZe8Grg%3D%3D%0A)

Once added, choose the appropriate target sharing platforms as shown:

[![](https://storage.crisp.chat/users/helpdesk/website/-/f/9/a/5/f9a5c40fe4482800/ccb33ace-1963-41ed-8ae4-255e2e_1stm9ss.png)](https://downloads.intercomcdn.com/i/o/767680589/eaa523d4d4c71ec6a7734d68/image.png?expires=1794512700&signature=096222184fac9530d37e64c05277e2af6343ead30aa71044b53596c5b507dfca&req=cyYgEMF%2BmIlWFb4f3HP0gHNEFJqHMrH0taj1WFC1L2Tll%2BTbfT9DHi0KmJip%0AjaO4CUsbyaA2yAEChg%3D%3D%0A)

The resulting unified share modal displays accordingly:

[![](https://storage.crisp.chat/users/helpdesk/website/-/a/1/9/f/a19fdcef1a8a4800/5e78915f-3b15-4cc0-b49e-5d1a5a_ekea8y.png)](https://downloads.intercomcdn.com/i/o/767682448/3472cadc84759eae18b983b2/image.png?expires=1794512700&signature=3ac27b10197bfbda59b9fa0114f8f26731b7c830d290652a1b2479db1cff88a2&req=cyYgEMF8mYVXFb4f3HP0gIo1GfHY%2BpzF4ESpmfNjvd06gVeWF5y1XODUQS%2FL%0ACR%2B1V6mptc3deKnx%2Bw%3D%3D%0A)

The link that is shared updates accordingly **after the Interface is installed on your Website**.

On mobile devices that support native share, the dialog is not shown, instead the native share dialog is displayed:

[![](https://storage.crisp.chat/users/helpdesk/website/-/6/8/b/9/68b9603466e7f800/4e82b321-87f2-4e9a-817b-820b4c_3cxwvz.jpg)](https://metalocator.intercom-attachments-1.com/i/o/479088113/202204ba5b335298935ab671/features-mobile-share-montage-1500w.jpg?expires=1794512700&signature=c9c1743eb4b02d0a004503238764f95fc92d6e9a108ba91c8bc9bf64d8acbf92&req=cCcuFsF2nIBcFb4f3HP0gE81k%2BZG%2BcR%2FV%2BVVEvPUqXZpYH049NgEOfteRTj4%0AacjTs1X8YWowKqxeLQ%3D%3D%0A)

## Appending Custom Parameters to the Shared URL

MetaLocator supports **custom query parameters** in the shared URL through a special deep linking parameter called `ml_share_append[]`.

This feature allows you to include custom tracking or contextual data—such as UTM parameters or campaign tags—on the **“Share Location”** link by passing base64-encoded `name=value` pairs via the page URL.

### Use Case

This is useful when you want the shared link to include analytics tracking data or personalized flags when a user clicks **Share** on a location card or detail panel.

### How it Works

You can append one or more `ml___ml_share_append[]` parameters to the page URL. Each value must be a **base64-encoded string** in the format:

```
parameterName=parameterValue
```

When the Share button is clicked, each valid `ml_share_append[]` entry is decoded and added to the generated share link as a standard query string parameter.

### Example

Let’s say you want to include the following two parameters:

* `utm_source=newsletter`
* `campaign=summer2025`

#### Step 1: Base64 Encode the Parameters

```
utm_source=newsletter → dXRtX3NvdXJjZT1uZXdzbGV0dGVy   
campaign=summer2025 → Y2FtcGFpZ249c3VtbWVyMjAyNQ==
```

#### Step 2: Add to the Interface URL

```
https://locator.example.com/?ml___ml_share_append[]=dXRtX3NvdXJjZT1uZXdzbGV0dGVy&ml___ml_share_append[]=Y2FtcGFpZ249c3VtbWVyMjAyNQ==
```

#### Step 3: Click Share

The resulting shared URL will include the decoded parameters:

```
https://locator.example.com/share?location=123&utm_source=newsletter&campaign=summer2025
```

### Notes

* You may include multiple `ml_share_append[]` parameters—each one will be evaluated individually.
* Only properly base64-encoded `key=value` strings will be processed. Invalid entries are ignored.
* Parameters are appended without overriding existing query string parameters unless there’s a key collision.

### Security Considerations

* Ensure base64 strings are properly encoded to avoid malformed URLs.
* MetaLocator sanitizes all appended parameters to prevent injection or misuse.