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.
Once added, choose the appropriate target sharing platforms as shown:
The resulting unified share modal displays accordingly:
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:
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=newslettercampaign=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=valuestrings 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.