Important: this documentation is not applicable to your currently selected format stories!
Displays AddThis customizable social share buttons.
<script async custom-element="amp-addthis" src="https://cdn.ampproject.org/v0/amp-addthis-0.1.js"></script>
amp-addthis component provides beautiful, simple share buttons. Make it easy for your website visitors share content to over 200 social channels including Messenger, WhatsApp, Facebook, Twitter, Pinterest and many more.
AddThis is trusted by over 15,000,000 websites with over 2 billion unique users, sharing content all over the world, in more than sixty languages.
Placed on the sides, top, or bottom of your page, following your reader as they scroll. A great way to promote sharing without getting too in-your-face.
<!-- This example uses a placeholder pubId. Please replace the pubId value with your own after creating an account on https://www.addthis.com/dashboard. --> <amp-addthis width="320" height="92" layout="responsive" data-pub-id="ra-5c191331410932ff" data-widget-id="957l" data-widget-type="floating" > </amp-addthis>
Integrate share buttons into your content for a seamless sharing experience.
<!-- This example uses a placeholder pubId. Please replace the pubId value with your own after creating an account on https://www.addthis.com/dashboard. --> <amp-addthis width="320" height="92" data-pub-id="ra-5c191331410932ff" data-widget-id="mv93" data-widget-type="inline" > </amp-addthis>
|data-pub-id||The AddThis publisher ID found in the URL in the AddThis dashboard after logging in. For example, in the URL |
|data-widget-id||The AddThis widget ID for the tool to be displayed, also found on the AddThis dashboard. The widget Id for a specific tool can be found by opening that tool in the AddThis dashboard and copying the last part of the URL. For example, in the URL |
|data-widget-type||Attribute that describes the type of widget.
|data-title||Optional. If set, this is the title that the AddThis tool will attempt to share when sharing occurs. If not set, the title of the document containing the |
|data-url||Optional. If set, this is the URL that the AddThis tool will attempt to share when sharing occurs. If not set, the |
|data-media||Optional. If set, this is an URL for a piece of media (e.g., image or video) that the AddThis tool will attempt to share when sharing occurs. If not set, this is left undefined.|
|data-description||Optional. If set, this is the description of the page that the AddThis tool will attempt to share when sharing occurs. If not set, this is left undefined.|
- If you haven’t already, you will need to create an AddThis account at https://www.addthis.com/register. Creating an AddThis account is entirely free and allows you to access our entire suite of website tools as well as our in-depth analytics reports to better understand your site’s social traffic.
- Go to your dashboard and customize your Share Buttons (AMP currently only supports Floating & Inline Share Buttons).
- Customize your sharing buttons to your liking, then hit “activate tool”. This will redirect you to our Get The Code page.
- Last but not least, copy and paste the inline code into the body section of your page where you want the share buttons to appear. For the Floating Share Buttons, you can place this code anywhere in the body as it will automatically appear on either the left or right side of your screen, depending on where you’ve set it in the tool’s settings.
And that’s it! You should see the share buttons appearing on your page!
Check out our YouTube video for step-by-step instructions:
See amp-addthis rules in the AMP validator specification.
The AddThis Tools and AddThis Toolbar collect information from the device used by the End User to interact with Publisher Sites or by the Toolbar User to interact with the AddThis Toolbar (“AddThis Data”).
AddThis Data may consist of the following:
- Internet Protocol (IP) address, Mobile Advertising ID (MAID) (which allows mobile app developers to identify who is using their mobile apps), mobile application ID, browser type, browser language, type of operating system, and the date and time the End User visited a Publisher Site or Toolbar
- User used the Toolbar;
- Behavior on a Publisher Site, such as how long the End User visited the Publisher Site, End User sharing behavior of content on a Publisher Site, and scrolling behavior of an End User on a Publisher Site;
- The referring URL and the web search the End User used to locate and navigate to a Publisher Site;
- Keywords entered into the AddThis Toolbar search functionality, and whether and when the Toolbar User downloads, installs, or uninstalls the AddThis Toolbar;
- Information regarding how often an End User uses the AddThis Tools and how often a Toolbar User uses the AddThis Toolbar; and
- Geo-location data derived from an End User’s and Toolbar User’s IP address.
AddThis Data will be treated as personal information to the extent required under applicable law. Publishers are required per the AddThis Terms of Service to obtain all necessary End User consents and authorizations, and provide any required notices for the provision of AddThis Data collected from End Users to Oracle.
You've read this document a dozen times but it doesn't really cover all of your questions? Maybe other people felt the same: reach out to them on Stack Overflow.Go to Stack Overflow Found a bug or missing a feature?
The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.Go to GitHub