Support

Custom Services

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: Sep 11, 2013 02:58PM EDT
help@addthis.com
http://assets01.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