Turn sharing on, and every listing in your app gets a share button — a tap that sends the listing to friends through the phone’s native share sheet: Messages, Mail, WhatsApp, social apps, whatever’s on hand. It’s a quick way to turn the audience you already have into a referral channel, no code required.

Here’s how to switch sharing on for listings, control the message that goes out with each share, and decide whether the shared link points to your website or opens the app itself.

Before you start

• You need access to the Mobile App Manager admin area for your app.
• Sharing is configured under the listings app settings, so it applies to your app’s listing detail screens.
• No app rebuild is required — these are content settings that update with your normal app data refresh.

The three settings

Three app settings control listing sharing, all living in the Listings group of the app settings page:

Behind the scenes, these map to the setting variables listing_sharing_button, listing_sharing_message, and listing_sharing_use_site_url. You don’t need these names to configure sharing — they’re listed here so you can trace what you set in the UI back to your app’s payload (the bundle of data your app downloads from your site), if you ever need to.

Step 1 — Turn the share button on

1. In the WordPress admin, open Mobile App Mgr → App Settings.
2. Select the Listings tab.
3. Set Show sharing button to Yes.

Flip this one setting, and a share button shows up on every listing detail screen. The other two settings below are optional refinements, once the button itself is live.

Step 2 — Set the default share message

1. In the same Listings tab, find Listing Sharing Message.
2. Enter the message you want pre-filled when a user shares a listing — for example, a short call to action like “Check this out on our app:”.

This is the text that goes out ahead of the listing link, whatever app your user shares through. Keep it short and friendly — some apps will truncate a long message before your reader gets to the rest.

Note: How the message and link get combined — message plus URL, or message alone — is handled by the app itself. Check the real formatting on a test device before you publish.

Step 3 — Choose where the shared link points

The List Sharing – Use Site URL? setting decides where that shared link actually leads:

• Yes — share the website URL. The recipient opens the listing on your public website in a browser. Reach for this when most recipients won’t have the app installed, or when your website listing is the canonical, link-friendly version.
• No — share an app/deep link. The recipient gets a link meant to open the listing right inside the app (or nudge them toward installing it first). Reach for this when the goal is app engagement and installs, not web traffic.

There’s no one “correct” choice here — it comes down to whether you’re after web reach or app engagement. Many teams start with Site URL = Yes, since plain web links are the most reliable across every messaging app, then revisit once deep linking is fully set up for the app.

Step 4 — Save and test

1. Save your app settings.
2. Refresh your app data (or reload the app on a test device) so the new settings take effect.
3. Open any listing in the app and confirm the share button appears.
4. Tap it and run through a real share — for example, send the listing to yourself by email — and confirm the message text and link destination match what you configured.

Choosing your configuration

A quick guide to the common setups:

• Drive web traffic / simplest setup: Show sharing button = Yes, Use Site URL = Yes, plus a friendly message.
• Drive app installs and in-app engagement: Show sharing button = Yes, Use Site URL = No (deep link), plus a message that invites the recipient into the app.
• No sharing: Show sharing button = No. The other two settings are ignored.

Troubleshooting

• No share button appears on listings. Confirm Show sharing button is set to Yes, then refresh the app data on the device again. A stale cached payload is the most common cause.
• Shared message is blank or generic. Set Listing Sharing Message to the text you want. Leave it empty, and the share may go out with just the link.
• Recipients land on the website when you expected the app to open (or vice versa). Check List Sharing – Use Site URL? — Yes means website, No means app/deep link. If you chose the deep-link option, also confirm deep linking is configured for your app build.

Related settings

• App Setting: Show sharing button (listing_sharing_button)
• App Setting: Listing Sharing Message (listing_sharing_message)
• App Setting: List Sharing – Use Site URL? (listing_sharing_use_site_url)

Verification

This article was last verified against:

• mam-main/includes/app-settings/admin-settings-page.php — the listings category settings listing_sharing_button (yes-no), listing_sharing_message (text), and listing_sharing_use_site_url (yes-no).
• App-setting reference docs app-setting-listing_sharing_button, app-setting-listing_sharing_message, and app-setting-listing_sharing_use_site_url.

Re-verify whenever the listing sharing setting variables, their UI labels, or their setting types change, or when the app’s share-link formatting behavior is changed.