Install this theme component
Features
This component only works on public sites .
Share icons will be automatically disabled on private sites when site setting login required
is active.
Manipulating settings related to crawler user agents could potentially interfere with the proper functioning of the component.
Settings:
Name
Descriptions
social share links
Comma delimited in this order: name, icon, title, link.
svg icons
List of FontAwesome 5 icons used in this theme component. Use prefix fa-
for solid icons, far-
for regular icons and fab-
for brand icons.
Some providers & Links:
English Social Media
Provider
Sharing URL
Tumblr
https://www.tumblr.com/widgets/share/tool?canonicalUrl=
Pinterest
https://pinterest.com/pin/create/button/?url=
LinkedIn
https://www.linkedin.com/shareArticle?mini=true&url=
Reddit
https://www.reddit.com/submit?url=
Pocket
https://getpocket.com/edit?url=
Evernote
https://www.evernote.com/clip.action?url=
HackerNews
https://news.ycombinator.com/submitlink?u=
Digg
https://digg.com/submit?url=
Flipboard
https://share.flipboard.com/bookmarklet/popout?v=2&title=
Instapaper
https://www.instapaper.com/edit?url=
Diaspora
https://share.diasporafoundation.org/?title={title}&url=
Viber
viber://forward?text=
Mastodon
https://mastodonshare.com/?url=
Threads
https://www.threads.net/share?url=
Bluesky
https://bsky.app/intent/compose?text=
Mix.com
https://mix.com/add?url=
MeWe
https://mewe.com/share?link=
International (non-english) Social Media
Provider
Sharing URL
QZone (China)
http://sns.qzone.qq.com/cgi-bin/qzshare/cgi_qzshare_onekey?url=
Weibo (China)
http://service.weibo.com/share/share.php?url=
Douban (China)
https://www.douban.com/recommend/?url=
RenRen (China)
http://widget.renren.com/dialog/share?resourceUrl=
VK (Russia)
https://vk.com/share.php?url=
OK.ru (Russia)
https://connect.ok.ru/dk?st.cmd=WidgetSharePreview&st.shareUrl=
Xing (Germany)
https://www.xing.com/app/user?op=share&url=
SurfingBird (Russia)
http://surfingbird.ru/share?url=
Phone/Audio-Based Social Media
Provider
Sharing URL
SMS
sms:{phone_number}?body=
Telegram
https://telegram.me/share/url?url=
Line
https://lineit.line.me/share/ui?url=
Skype
https://web.skype.com/share?url=
WhatsApp
https://wa.me/?text=
WhatsApp Web
https://web.whatsapp.com/send?text=
(read also here )
This guide is a wiki, if you have other providers, maybe specific for your country, just add them to the list.
You will find the share URL in the documentation for the developers.
Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.
Last edited by @dax 2025-05-09T19:43:20Z
Check document Perform check on document:
75 Likes
dax
(Daniela)
May 12, 2019, 10:44am
31
Premise: I do not use, nor have I ever used Instagram but , I do not believe that Instagram have a share button at all, for sure there is a “follow” button that you can add if you want it.
Something like this should work (maybe)
instagram,instagram,follow me on instagram,https://www.instagram.com/your-instagram-username/?ref=
3 Likes
cogdog
(Alan Levine)
September 16, 2020, 5:19am
57
In the Component Settings:
social share links: LinkedIn, fab-linkedin, Share to LinkedIn, https://www.linkedin.com/shareArticle?mini=true&url=
svg-icons: fab-linkedin
I think I had to do force-refresh in the browser to nudge it.
4 Likes
Kuro22
March 24, 2022, 2:21pm
71
Hey! I saw in your post that you added weixin sharing. I’d like to add this too. Could you share with me the link? Thanks in advance!
weixin://dl/moment??
dax
(Daniela)
March 28, 2022, 12:21pm
72
It’s
weixin://dl/moments
but please note that it’s a unofficial deep linking URL so it may stop working if Wechat should change/remove it.
More info at
mobile-website, wechat
Anyway, if you configure it correctly and works, add it to the list in the first post of this topic.
Kuro22
March 29, 2022, 5:18am
73
Thanks for your response. Unfortunately, it doesn’t work. On clicking the sharing button, WeChat was called up but with no more reaction.
I searched “wechat url scheme” on Chinese Internet, the results indicate that WeChat doesn’t support this kind of deep link any more since 2 or 3 years ago.
1 Like
I think the changes that were made to the share dialog a couple months back might’ve broken this theme-component . It doesn’t appear to be working.
I installed this plugin but it is not showing in my plugin list.
I added the plugin to my app.yml (- git clone GitHub - discourse/discourse-social-share )
Then I rebuilt the container (cd /var/discourse, ./launcher rebuild app)
I am not sure why the plugin is not showing up on the list
Moin
June 24, 2022, 9:02pm
76
This is a theme-component.
So you need to follow How do I install a Theme or Theme Component?
3 Likes
Thanks @Moin . I will try that
dax
(Daniela)
September 14, 2022, 1:25pm
78
The component still works, but only on public sites. Some time ago we disabled the ability to share posts and topics on social providers when the sites are private.
I just updated the OP accordingly.
5 Likes
Thanks a bunch! The plugin was causing a bunch of conflicting issues with my forum. Now I know why!
2 Likes
busfactor
(busfactor)
March 7, 2023, 8:46pm
80
hmm, using on a public site and still not showing correctly…
1 Like
This looks great, but how do we add custom icons that are not found on Font Awesome?
Oh, I may have found something:
You can replace a Discourse’s default SVG icons individually or as a whole with your own custom SVG and override them within a theme or theme component.
Step 1 - Create an SVG Spritesheet
To get started, you must create an SVG Spritesheet. This can contain anything from a single additional custom SVG icon up to an entire replacement set of hundreds.
The spritesheet should be saved as an SVG file. In principle, you are nesting the <svg> tag contents from the original SVG icon file into <symbo…
volanar
(Volanar)
August 4, 2023, 7:48pm
82
What is the difference between this component and the built-in share function?
1 Like
The built-in share function only supports a limited number of options like twitter/facebook and email, this component allows any link to be added.
3 Likes
volanar
(Volanar)
August 4, 2023, 8:20pm
84
That is, this module complements the built-in share function, but does not replace it.
1 Like
This is fantastic, thanks so much! It’s a great addition and I love the customization we’re able to add.
I did notice an issue or perhaps a misconfiguration on my part. When highlighting text to share as a quote, the mini tool bar wants to list every custom share icon I added and it won’t fit. I tried to scroll and arrow over, but it’s just cut off. Not a show stopper, but maybe of interest to the devs.
I jumped over to share quote buttons
but it doesn’t look like I can add or remove anything there.
Tip:
For anyone that wants to implement this, but with social networks not on the list. Make sure you read Replace Discourse's default SVG icons with custom icons in a theme and How to overrule a color variable for one theme only? - #7 by smrtey which will walk you through configuring about.json
, that’s key so you can add the icons-sprite.svg
file!
If you want to replace share icons, this thread is your friend, Use standard share icon for share post (instead of link icon) - #9 by bquast
cogdog
(Alan Levine)
October 31, 2023, 5:59pm
86
Woot! Was able to add a Share to Mastodon link using
https://mastodonshare.com/?url=
- popup asks for instance, then creates the proper setup to post.
2 Likes
cogdog
(Alan Levine)
May 27, 2024, 6:11pm
87
I am now liking a new service for providing share links, ShareOpenly https://shareopenly.org/ because it not only provides a means to share links to Mastodon, but also Threads, Blusky, and more.
I have modified by settings in Social Share to use
Share Openly, fab-mastodon, Share Openly, https://shareopenly.org/share/?url=
I am in search of a different icon, but its working in my community:
1 Like