Support

What happened to the articles?
You might have noticed that our support portal looks a bit different. We decided to do a little tidying up, so moving forward, support articles will be updated and housed on the AddThis Academy. For the most up to date articles, as well as other support documentation, please visit us at www.addthis.com/academy. If you need additional help, you can submit a help ticket using the form below. Thanks!

Custom Services

NOTICE: Moving forward, support articles will be updated and housed on the AddThis Academy. For the most up to date articles, as well as other support documentation, please visit us at www.addthis.com/academy. If you need additional help, you can submit a help ticket via the support link in the footer. Thanks!

Any public service is eligible to be placed in our directory for all to use. Since approval can take up to a month, and some services are not for public consumption (e.g., on a private intranet, or invitation-only), you may also add any service to your own menu at run-time.



Optional Arguments

services_custom Optional Array
Specify your own AddThis bookmarking services with an array of Javascript configuration object added to the global addthis_config variable:
[{
   name: "My Service",
   url: "http://example.com/share?url={{url}}&title={{title}}",
   icon: "http://example.com/icon.jpg"
},{
   name: "My Second Service",
   url: "http://secondexample.com/share?url={{url}}&title={{title}}",
   icon: "http://secondexample.com/icon.jpg"
}]
All three fields must be present for each custom service. In an AddThis toolbox, the custom service's hostname is its unique identifier. In the example above, you could create a chiclet for "My Service" with the class "addthis_button_example.com".

By default, we assume your icon is 16x16.  For buttons, you need to add either "16x16", "20x20" or "32x32" to the class in your HTML markup to specify the size.  For toolboxes, use "addthis_16x16_style", "addthis_20x20_style" or "addthis_32x32_style".

Note: as of AddThis 3.0, custom services no longer appear in the compact menu by default.

Code Examples

Example #1

This example creates an AddThis button.

<script type="text/javascript">
var addthis_config = {
      services_custom: [{
              name: "AddThis",
              url: "http://addthis.com/bookmark.php?url={{url}}&title={{title}}",
              icon: "http://addthis.com/images/addthis32.gif"
      }]
}
</script>

<a class="addthis_button_addthis.com 32x32"></a>

Example #2

This example adds an AddThis toolbox with your custom service.

<script type="text/javascript">
​var addthis_config = {
      services_custom: [{
              name: "AddThis",
              url: "http://addthis.com/bookmark.php?url={{url}}&title={{title}}",
              icon: "http://addthis.com/images/addthis32.gif"
      }]
}
</script>

<div class="addthis_toolbox addthis_default_style addthis_32x32_style">
    <a class="addthis_button_preferred1"></a>
    <a class="addthis_button_preferred2"></a>
    <a class="addthis_button_preferred3"></a>
    <a class="addthis_button_addthis.com"></a>
​    <a class="addthis_button_compact"></a>
</div>

Example #3

This example adds your custom service to our expanded menu.

<script type="text/javascript">
var addthis_config = {
      services_custom: [{
              name: "AddThis",
              url: "http://addthis.com/bookmark.php?url={{url}}&title={{title}}",
              icon: "http://addthis.com/images/addthis32.gif"
      }]
}
</script>

<a href="http://www.addthis.com/bookmark.php" 
     class="addthis_button"></a>
Share


API Reference

Check out the full Client API specification to learn more.

Last Updated: Oct 28, 2015 02:59PM EDT
help@addthis.com
http://assets0.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete