Viral Share Action

This documentation covers how Viral Share Actions work.

Applications that support Viral Share actions:

Viral Share allows your entrants to refer their friends & family to enter your Competition. A unique referral link is created for each entrant which allows them to share their link to others and get credited for each successful referral.

Validation: Automatic


Remember, the original user will only get their entries credited if the referral enters through their unique Viral Share link.

You have multiple options with Viral Sharing:

  • You can limit it until a certain number of actions have already been completed.
  • You can specify how many entries per share a user gets.
  • You can choose to allow sharing via Email, Facebook, Twitter, Tumblr, LinkedIn, Whatsapp, Messenger, Telegram & SMS.
  • If you have mandatory actions you can show it alongside them (however it's not mandatory that they virally share to enter).
  • Viral Share will auto-expand if it is the last entry method left to be completed.
  • You can set a custom body text for sharing via Email/Tumblr/SMS/Whatsapp.
  • You can set a custom share image for Facebook (this does not work for LinkedIn).
  • Some share types (SMS, WhatsApp, Messenger, Telegram) require the corresponding app to be installed on the device.
Admin view for Viral Share action on

The Viral Sharing link can only be generated once a user has logged into the widget. Once logged in they will get generated a unique sharing link that will send people they refer to your landing page.


You can shorten the viral links by setting up in your Settings > Integrations otherwise we use our own shortdomain.

Sometimes you may want to ensure the Viral Share gets automatically expanded so users know to complete it. The Viral Share will always auto expand if it is the last available action to be completed in the contest.

Clicking the sharing via email button uses the mailto: parameter to automatically pre-compose an email that your users can send to their friends.

This method is preferable to just entering a list of emails as it comes directly from the entrant & is CAN-SPAM compliant.

The default share text gets used as the subject line.

Body text for a Viral Share email

You can change the text in the email by editing the Share Body field.

Facebook does not allow you to prefill the share text, so in this case we use the default share text as the title and the description from your Prize as the description.

Share a Gleam Competition on Facebook

When sharing on Tumblr we use the default share text as the title then the users are free to enter whatever they wish in the description field.

Share a Gleam Competition on Tumblr

When sharing on Twitter / X we will use the default share text as the Tweet, then the URL will get appended on the end. If your landing page is setup for Twitter / X Cards then you can show them when the Tweet gets posted.

Share a Gleam Competition on Twitter / X

When sharing on Telegram we will use the default share text as the message body, with the URL prepended at the beginning.

If the entrant is sharing from desktop, they'll be redirected to the Telegram app or Telegram Web.

Share a Gleam Competition on Telegram (Desktop)

If the entrant is sharing from mobile, they'll be redirected to the Telegram app to choose a recipient:

Share a Gleam Competition on Telegram (Mobile)

Currently, a user isn't entered into a competition until they complete at least 1 action. This means if you just included Viral Share only, friends would need to refer friends, who then referred friends to enter. Which isn't very good.

The best way to get around this, is to turn on Require Login and also Automatic Entry.

This ensures that everyone that logs into your contest gets an entry, which means when they share the entries associated will get awarded.

This is probably one of the most common questions we get asked. Users will often expect to get their entries for sharing, not understanding that we credit entries when they successfully refer another user.

The description for the Facebook share text gets pulled from your Prize description which is on the Prize tab when editing your contest.

We have a global account with which often hits their rate limits, if that happens we default back to a share link. To avoid this you can add your own API key in the Settings > Integrations area which will exclusively use your own account.


If you generate a share link before activating it will only generate the new links for new entrants (not existing ones).

See Next Article

Visit Action

This documentation covers how Visit Actions work.