Social Sharing

Stable Version 1.0.0 (OutSystems 11)
Published on 20 Feb by 
Created on 20 Feb
This plugin allows you to use the native sharing window of your mobile device.
Read More

Sample Social Sharing:


  • Works on Android, version 2.3.3 and higher till 6.0 (For Version 7 and 8 still in progress)
  • Works on iOS6 and up.
  • Works on Windows Phone 8 since v4.0 of this plugin.
  • Share text, a link, images (or other files like pdf). A Subject is also supported when the receiving app supports it.

Supported platforms

  • Android
  • iOS
  • WP8

Since version 5.1.0 (for iOS and Android) it's recommended to use shareWithOptions as it's the most feature rich way to share stuff cross-platform. It will also tell you if sharing to an app completed and which app that was.


  • isAvailable : isAvailable(callback)
  • SocialSharing : It accepts an options object and callbacks. socialsharing(options, callback)
  • Options :
    • message - String // Not supported on some apps (Facebook, Instagram)
    • subject – String // For Email
    • files – [] // An array of filenames either locally or remotely (Dynamic And Customize)
    • url - String
    • chooserTitle - String // Android only, you can override the default share sheet title.
    • appPackageName - String // Android only, you can provide id of the App you want to share with
  • Callback : Return button index clicked.

Usage on iOS and Android

You can share text, a subject (in case the user selects the email application), (any type and location of) file (like an image), and a link. However, what exactly gets shared, depends on the application the user chooses to complete the action. A few examples:

  • Mail: message, subject, file.
  • Twitter: message, image (other filetypes are not supported), link (which is automatically shortened if the Twitter client deems it necessary).
  • Google+ / Hangouts (Android only): message, subject, link
  • facebook
  • Instagram
  • Whatsapp
  • SMS

If Facebook, Twitter, Instagram, WhatsApp, SMS or Email is not available, the errorCallback is called with the text 'not available'.

You can still use the older SHARE method as well

  • Twitter
  • Facebook
  • Instagram
  • Whatsapp
  • Mail
  • SMS


For Whatsapp

  • On iOS when sharing an image and text, only the image is shared.
  • On Android you can only send a 'text' and 'url' directly to someone, so files are ignored.


  • On Android, SMS via Hangouts may not behave correctly.

For Twitter

  • A lot of apps support sharing multiple files, but Twitter just doesn't accept more that one file.

 Thanks, @EddyVerbruggen for Cordova Plugin Git Repository

 Suggestions are most welcome !!

Reviews (0)
Applications, Mobile Plugins, Components, Samples & How-tos, Developer Tools
Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Viraj Kataria who created this component.
See all 1 dependencies
Component Consumers
See all 1 consumers
Weekly Downloads 
Related Components
Silk UI Web
OutSystems R&D
A fully responsive and beautiful UI framework that works within the OutSystems Platform. Build amazing looking applications, in a fraction of the time, which work perfectly across devices. Learn how to start using Silk UI and see the examples at . Obtain assistance on using Silk UI in our forums .
Architecture Team
A tool to discover and measure your architecture and understand how to improve
OutSystems Now
OutSystems R&D
OutSystems Now brings your OutSystems experience to any device.
More from Viraj Kataria
Rapid Strings
Customize & JS Strings Manipulation Function Other then Outsystems for Easy to implement and makes coding more lowcode
Android iOS Shared User Preferences
An interface to the user’s defaults database, where you store key-value pairs persistently across launches of your app. - Supports both Android [ Shared Preferences ] & iOS [ User Preferences ]
iRoot - Android iOS Jailbreak/Root Detection
Cordova Jailbreak/Root Detection