AddThis Toolbox
Want to display individual sharing services instead of one button? Create your own sharing menu? No problem! The AddThis Toolbox provides publishers more control over the display of sharing services on their site.
- Create custom sharing menu configurations
- New! Select your own services, or let AddThis optimize your service list
- Receive the same analytics, performance and reliability as the standard AddThis button
- Toolbox implementations adopt the CSS styling of your site (so your versions of the examples below may look different!)
Toolbox Examples
The examples below demonstrate just a few of the ways that sharing services can be presented. To get started quickly, you can grab the code from any of these implementations and use it as-is, alter the code as you see fit, or more deeply customize using the AddThis Menu API.
Note: Text in these examples will, when copied and pasted elsewhere, take on the style of the containing page unless specifically overridden. In other words, by default they'll use your fonts, your link colors, and so forth.
Default Styling
This is the default AddThis Toolbox layout if you don't want to provide your own styling.
To use this style the div wrapping the destination buttons needs to look like this: <div class="addthis_toolbox addthis_default_style">.
JavaScript
Before customizing your toolbox, get the default toolbox code.
HTML
<div class="addthis_toolbox addthis_default_style">
<a class="addthis_button_email"></a>
<a class="addthis_button_print"></a>
<a class="addthis_button_twitter"></a>
<a class="addthis_button_facebook"></a>
<a class="addthis_button_myspace"></a>
<a class="addthis_button_stumbleupon"></a>
<a class="addthis_button_digg"></a>
<span class="addthis_separator">|</span>
<a class="addthis_button_expanded">More</a>
</div>
Choosing your Destinations
The way you set the destination and the default icon: <a class="addthis_button_destination"></a>
Some examples
Digg
Compact
Expanded
<a class="addthis_button_email"></a><a class="addthis_button_facebook"></a> <a class="addthis_button_digg"></a><a class="addthis_button_compact"></a> <a class="addthis_button_expanded"></a> The AddThis Service Directory contains details about all services supported by AddThis, a complete list of service codes, and a form to submit your favorite service.
JavaScript
Before customizing your toolbox, get the default toolbox code.
HTML
<h4>Destinations</h4>
<div class="addthis_toolbox addthis_default_style">
<a class="addthis_button_aim"></a>
<a class="addthis_button_ask"></a>
<a class="addthis_button_bebo"></a>
<a class="addthis_button_buzz"></a>
<a class="addthis_button_delicious"></a>
<a class="addthis_button_digg"></a>
<a class="addthis_button_facebook"></a>
<a class="addthis_button_favorites"></a>
<a class="addthis_button_fark"></a>
<a class="addthis_button_friendfeed"></a>
<a class="addthis_button_google"></a>
<a class="addthis_button_hyves"></a>
<a class="addthis_button_linkedin"></a>
<a class="addthis_button_live"></a>
<a class="addthis_button_meneame"></a>
<a class="addthis_button_misterwong"></a>
<a class="addthis_button_mixx"></a>
<a class="addthis_button_myaol"></a>
<a class="addthis_button_myspace"></a>
<a class="addthis_button_propeller"></a>
<a class="addthis_button_reddit"></a>
<a class="addthis_button_segnalo"></a>
<a class="addthis_button_slashdot"></a>
<a class="addthis_button_stumbleupon"></a>
<a class="addthis_button_technorati"></a>
<a class="addthis_button_twitter"></a>
<a class="addthis_button_viadeo"></a>
<a class="addthis_button_yahoobkm"></a>
</div>
<br />
<div class="addthis_toolbox addthis_default_style">
<h4>Special Services</h4>
<a class="addthis_button_email">&nbsp;Email</a><br />
<a class="addthis_button_print">&nbsp;Print</a><br />
<a class="addthis_button_compact"> Compact Menu (drop down)</a><br />
<a class="addthis_button_expanded"> Expanded Menu (pop-in)</a><br />
</div>
Adding Tooltips
It's easy to add our own tooltips with toolbox.
Add a tooltip this way: <a class="addthis_button_destination code".
title="Tooltip"></a>
JavaScript
Before customizing your toolbox, get the default toolbox code.
HTML
<div class="addthis_toolbox addthis_default_style">
<a class="addthis_button_email" title="Email"></a>
<a class="addthis_button_print" title="Print"></a>
<a class="addthis_button_twitter" title="Tweet This"></a>
<a class="addthis_button_facebook" title="Share to Facebook"></a>
<a class="addthis_button_myspace" title="Share to MySpace"></a>
<a class="addthis_button_stumbleupon" title="StumbleUpon"></a>
<a class="addthis_button_digg" title="Digg This"></a>
<span class="addthis_separator">|</span>
<a class="addthis_button_expanded" title="More Choices">More</a>
</div>
No Styling
This is the same code as the default but without the class addthis_default_style.
This is your blank slate. You should be able to build almost any layout and design from here.
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
HTML
<div class="addthis_toolbox">
<a class="addthis_button_email"></a>
<a class="addthis_button_print"></a>
<a class="addthis_button_twitter"></a>
<a class="addthis_button_facebook"></a>
<a class="addthis_button_myspace"></a>
<a class="addthis_button_stumbleupon"></a>
<a class="addthis_button_digg"></a>
<a class="addthis_button_expanded">More</a>
</div>
Hover Effect
Move your mouse over the icons. This simple effect can help your users know that the icons are clickable. (This effect does not work in Internet Explorer 6.)
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .hover_effect
{
width: 284px;
padding: 10px 0 6px 10px;
border: 3px solid #eee;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
}
.addthis_toolbox .hover_effect div
{
float: left;
}
.addthis_toolbox .hover_effect a
{
border: 2px solid #fff;
padding: 2px 2px 2px 16px;
position: relative;
text-decoration: none;
}
.addthis_toolbox .hover_effect a:hover
{
border: 2px solid #105CB6;
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
background: #B4D3F8;
color: #105CB6;
text-decoration: none;
}
.addthis_toolbox .hover_effect span
{
position: absolute;
width: 16px;
height: 16px;
top: 2px;
left: 1px;
}
HTML
<div class="addthis_toolbox">
<div class="hover_effect">
<div><a class="addthis_button_email">&nbsp;Email</a></div>
<div><a class="addthis_button_print">&nbsp;Print</a></div>
<div><a class="addthis_button_twitter">&nbsp;</a></div>
<div><a class="addthis_button_facebook">&nbsp;</a></div>
<div><a class="addthis_button_myspace">&nbsp;</a></div>
<div><a class="addthis_button_digg">&nbsp;</a></div>
<div><a class="addthis_button_expanded">&nbsp;More...</a></div>
<div style="clear:both; float:none;"></div>
</div>
</div>
Vertical Layout
We've made this menu vertical to better fit a sidebar.
We've also added labels to make it easier to understand and less cluttered.
We're hiding the icon next to "More Destinations" to give more room to the text.
The mouseover effect is a nice little effect that helps users know this is something that can be clicked.
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .vertical
{
width: 136px;
padding: 10px 0 10px 0;
border: 3px solid #eee;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
}
.addthis_toolbox .vertical a
{
width: 102px;
padding: 4px 0 4px 34px;
position: relative;
display: block;
text-decoration: none;
color: blue;
}
.addthis_toolbox .vertical a:hover
{
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
background: #B4D3F8;
text-decoration: none;
}
.addthis_toolbox .vertical span
{
position: absolute;
left: 14px;
top: 4px;
}
.addthis_toolbox .vertical .more
{
border-top: solid 1px #eee;
padding: 10px 0 0 0;
margin: 10px 10px 0 10px;
text-align: center;
}
.addthis_toolbox .vertical .more a
{
padding: 4px 0;
margin: 0;
}
.addthis_toolbox .vertical .more span
{
display: none;
}
HTML
<div class="addthis_toolbox">
<div class="vertical">
<a class="addthis_button_email">Email</a>
<a class="addthis_button_print">Print</a>
<a class="addthis_button_twitter">Twitter</a>
<a class="addthis_button_facebook">Facebook</a>
<a class="addthis_button_myspace">MySpace</a>
<a class="addthis_button_stumbleupon">Stumble</a>
<a class="addthis_button_digg">Digg</a>
<div class="more">
<a class="addthis_button_expanded">More Destinations</a>
</div>
</div>
</div>
Two Column Vertical
We've modified the Vertical layout to introduce two columns.
You could use a layout like this with your favorite destinations to create your own version of the AddThis menu.
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .two_column
{
width: 216px;
padding: 10px 0 10px 0px;
border: 3px solid #eee;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
}
.addthis_toolbox .two_column a
{
padding: 4px 0 4px 34px;
position: relative;
width: 66px;
display: block;
text-decoration: none;
color: blue;
}
.addthis_toolbox .two_column a:hover
{
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
background: #B4D3F8;
text-decoration: none;
}
.addthis_toolbox .two_column span
{
position: absolute;
left: 14px;
top: 4px;
}
.addthis_toolbox .two_column .top
{
padding: 0 0 10px 0;
border-bottom: solid 1px #eee;
margin-bottom: 10px;
margin: 0 20px 10px 20px;
}
.addthis_toolbox .two_column .more
{
border-top: solid 1px #eee;
padding: 10px 0 0 0;
margin: 10px 20px 0 20px;
text-align: center;
}
.addthis_toolbox .two_column .more a
{
padding: 4px 0;
width: auto;
}
.addthis_toolbox .two_column .more span
{
display: none;
}
.addthis_toolbox .two_column .column1
{
width: 100px;
float: left;
}
.addthis_toolbox .two_column .column2
{
width: 100px;
float: left;
}
.addthis_toolbox .two_column .clear
{
clear: both;
padding: 0;
display: block;
height: 0;
width: 0;
}
HTML
<div class="addthis_toolbox">
<div class="two_column">
<div class="column1">
<a class="addthis_button_email">Email</a>
</div>
<div class="column2">
<a class="addthis_button_print">Print</a>
</div>
<div class="clear"></div>
<div class="top">
</div>
<div class="column1">
<a class="addthis_button_twitter">Twitter</a>
<a class="addthis_button_facebook">Facebook</a>
<a class="addthis_button_myspace">MySpace</a>
</div>
<div class="column2">
<a class="addthis_button_delicious">Delicous</a>
<a class="addthis_button_stumbleupon">Stumble</a>
<a class="addthis_button_digg">Digg</a>
</div>
<div class="clear"></div>
<div class="more">
<a class="addthis_button_expanded">More Destinations...</a>
</div>
</div>
</div>
Custom Images
Who says you have to use our icons? Use custom service icons to create your own toolbox or button. We've compiled a list of 3rd party websites you can download alternate icons from. View the gallery
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .custom_images a
{
width: 60px;
height: 60px;
margin: 0;
padding: 0;
}
.addthis_toolbox .custom_images a:hover img
{
opacity: 1;
}
.addthis_toolbox .custom_images a img
{
opacity: 0.75;
}
HTML
<div class="addthis_toolbox">
<div class="custom_images">
<a class="addthis_button_twitter"><img src="http://mysocialbuttons.com/socialicons/twitter.png" width="60" height="60" alt="Twitter" /></a>
<a class="addthis_button_facebook"><img src="http://mysocialbuttons.com/socialicons/facebook.png" width="60" height="60" alt="Facebook" /></a>
<a class="addthis_button_myspace"><img src="http://mysocialbuttons.com/socialicons/myspace.png" width="60" height="60" alt="MySpace" /></a>
<a class="addthis_button_digg"><img src="http://mysocialbuttons.com/socialicons/digg.png" width="60" height="60" alt="Digg" /></a>
</div>
</div>
This text will stay under the menu.
Custom Hover Menu
This example puts the Vertical menu above into a hover menu.
We've included some tricks to make the hover experience a little nicer, such as a hover delay so the menu doesn't show up or disappear right away.
Note: This advanced example requires JQuery to hide and show the menu. In order to use this code, you MUST install JQuery on your site: http://www.jquery.com and include its custom JavaScript in your page's HEAD.
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .custom_hover
{
position: relative;
}
.addthis_toolbox .custom_hover .custom_button
{
font-weight: bold;
padding: 4px;
-moz-border-radius: 5px 5px 0 0;
-webkit-border-radius: 5px 5px 0 0;
}
.addthis_toolbox .custom_hover .custom_button.active
{
background-color: #eee;
}
.addthis_toolbox .hover_menu
{
display: none;
position: absolute;
background: #fff;
}
.addthis_toolbox .custom_hover .tower
{
-webkit-border-radius: 0 5px 0 0;
-moz-border-radius-topleft: 0;
}
.addthis_toolbox .hover_menu
{
width: 136px;
padding: 10px 0 10px 0;
border: 3px solid #eee;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
}
.addthis_toolbox .hover_menu a
{
width: 102px;
padding: 4px 0 4px 34px;
position: relative;
display: block;
text-decoration: none;
color: blue;
}
.addthis_toolbox .hover_menu a:hover
{
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
background: #B4D3F8;
text-decoration: none;
}
.addthis_toolbox .hover_menu span
{
position: absolute;
left: 14px;
top: 4px;
}
.addthis_toolbox .hover_menu .more
{
border-top: solid 1px #eee;
padding: 10px 0 0 0;
margin: 10px 10px 0 10px;
text-align: center;
}
.addthis_toolbox .hover_menu .more a
{
padding: 4px 0;
margin: 0;
}
.addthis_toolbox .hover_menu .more span
{
display: none;
}
JavaScript
$(function()
{
$('.custom_button, .hover_menu').mouseenter(function()
{
$('.hover_menu').fadeIn('fast');
$('.custom_button').addClass('active');
$(this).data('in', true);
$('.hover_menu').data('hidden', false);
}).mouseleave(function()
{
$(this).data('in', false);
setTimeout(hideMenu, delay);
});
var delay = 400;
function hideMenu()
{
if (!$('.custom_button').data('in') && !$('.hover_menu').data('in') && !$('.hover_menu').data('hidden'))
{
$('.hover_menu').fadeOut('fast');
$('.custom_button').removeClass('active');
$('.hover_menu').data('hidden', true);
}
}
});
HTML
<div class="addthis_toolbox">
<div class="custom_hover">
<span class="custom_button">Hover over me</span>
</div>
<div class="hover_menu">
<div class="column1">
<a class="addthis_button_email">Email</a>
</div>
<div class="column2">
<a class="addthis_button_print">Print</a>
</div>
<div class="clear"></div>
<div class="top">
</div>
<div class="column1">
<a class="addthis_button_twitter">Twitter</a>
<a class="addthis_button_facebook">Facebook</a>
<a class="addthis_button_myspace">MySpace</a>
</div>
<div class="column2">
<a class="addthis_button_delicious">Delicous</a>
<a class="addthis_button_stumbleupon">Stumble</a>
<a class="addthis_button_digg">Digg</a>
</div>
<div class="clear"></div>
<div class="more">
<a class="addthis_button_expanded">More Destinations...</a>
</div>
</div>
</div>
Fancy Lightbox Menu
This example puts the choices in a custom-made lightbox.
This shows off the flexiblity of the toolbox. (This effect does not work in Internet Explorer 6.)
Note: This advanced example requires JQuery to hide and show the menu. In order to use this code, you MUST install JQuery on your site: http://www.jquery.com and include its custom JavaScript in your page's HEAD.
Show code for this exampleJavaScript
Before customizing your toolbox, get the default toolbox code.
CSS
.addthis_toolbox .lightbox {
position: fixed;
top: 200px;
left: 400px;
width: 480px;
color: #555;
}
.addthis_toolbox .lightbox .lightbox_top {
background: url(/cms-content/images/help/toolbox_example_lightbox_top.png) no-repeat 0 0;
height: 34px;
overflow: hidden;
position: relative;
}
.addthis_toolbox .lightbox .lightbox_top h4 {
display: inline;
position: absolute;
top: 12px;
left: 20px;
margin: 0;
padding: 0;
font-size: 14px;
font-weight: normal;
color: #fff;
}
.addthis_toolbox .lightbox .lightbox_close {
position: absolute;
top: 10px;
right: 20px;
font-weight: bold;
text-decoration: none;
color: #fff;
}
.addthis_toolbox .lightbox .lightbox_middle {
background: url(/cms-content/images/help/toolbox_example_lightbox_middle.png) repeat-y;
overflow: hidden;
}
.addthis_toolbox .lightbox .lightbox_content {
padding: 10px 20px;
}
.addthis_toolbox .lightbox .lightbox_bottom {
background: url(/cms-content/images/help/toolbox_example_lightbox_top.png) no-repeat 0 -34px;
height: 16px;
overflow: hidden;
}
.addthis_toolbox .lightbox_sharing
{
margin-left: 10px;
}
.addthis_toolbox .lightbox .columns A
{
text-indent: 0 !important;
float: none !important;
width: auto !important;
height: auto !important;
margin: 0 !important;
padding: 4px 0 4px 34px !important;
position: relative;
width: 76px !important;
display: block;
color: #ee145b;
}
.addthis_toolbox .lightbox .columns A:hover
{
-moz-border-radius: 4px;
-webkit-border-radius: 4px;
background: #F476A0;
color: #fff;
text-decoration: none !important;
}
.addthis_toolbox .lightbox .columns SPAN
{
padding: auto !important;
margin: auto !important;
position: absolute;
left: 14px;
top: 4px;
float: none !important;
}
.addthis_toolbox .lightbox .columns .column
{
width: 107px;
float: left;
padding: 0;
}
.addthis_toolbox .lightbox .frame
{
border: 2px solid #eee;
padding: 10px;
margin: 0 20px 0 0;
float: left;
}
.addthis_toolbox .lightbox .border
{
border-top: 1px dashed #333;
margin: 0 10px;
}
.addthis_toolbox .lightbox A.sharelink:hover,
.addthis_toolbox .lightbox A.lightbox_close:hover
{
text-decoration: underline;
}
JavaScript
$(function()
{
$('.sharelink').click(function()
{
$('.lightbox').fadeIn('fast');
return false;
});
$('.lightbox_close').click(function()
{
$('.lightbox').fadeOut('fast');
return false;
});
});
HTML
<div class="addthis_toolbox">
<a class="sharelink" href="#">Click this to see the lightbox!</a>
<div class="lightbox" style="display:none;">
<div class="lightbox_top">
<h4>Funky Sharing!</h4>
<a class="lightbox_close" href="#">Close [X]</a>
</div>
<div class="lightbox_middle">
<div class="lightbox_content">
<img src="http://farm1.static.flickr.com/178/428713835_c98f593cf8_t.jpg" width="82" height="100" alt="Good shot" class="frame" />
<h3>Share the photo</h3>
Some information about this item. Some information about this item. Some information about this item. Some information about this item. Some information about this item. Some information about this item. Photo from flickr user babybluebbw.
<div class="clear"></div>
</div>
<div class="lightbox_sharing source">
<div class="columns">
<div class="column">
<a class="addthis_button_email">Email</a>
<a class="addthis_button_print">Print</a>
</div>
<div class="column">
<a class="addthis_button_twitter">Twitter</a>
<a class="addthis_button_digg">Digg</a>
</div>
<div class="column">
<a class="addthis_button_facebook">Facebook</a>
<a class="addthis_button_myspace">MySpace</a>
</div>
<div class="column">
<a class="addthis_button_stumbleupon">Stumble</a>
<a class="addthis_button_expanded">More...</a>
</div>
<div class="clear"></div>
</div>
</div>
</div>
<div class="lightbox_bottom"></div>
</div>
</div>
Dynamic Toolbox Optimization
Although you can always choose to select your own services to appear in your AddThis Toolbox, you might want to consider taking advantage of the optimization and user personalization features built into AddThis menus. AddThis can determine the best set of services to display in your Toolbox based on overall usage, language and location, as well as user sharing history and preference. This is now possible via a new option available in the AddThis Menu API.
More About Customization
For more specific information about customizing your AddThis Toolbox, please reference the AddThis Menu API specification.