UI Configuration
You can set many global configuration options for your AddThis tools using the addthis_config variable.
For example:
<script type="text/javascript"> var addthis_config = { // ... members go here } </script>
UI Configuration Options
Name | Description | Type | Default |
---|---|---|---|
data_ga_property | Google Analytics property ID (generally a serial number of the form UA-xxxxxx-x). If set, we’ll send AddThis tracking events to Google, so you can have integrated reporting. | object or string | null |
data_ga_social | Google Analytics social interaction analytics. | boolean | null |
data_track_addressbar | Set to true to allow us to append a variable to the page URL. Measures how often users share your site by copying the page URL from their address bar. Always global. | boolean | false |
data_track_clickback | Set to true to allow us to append a variable to your URLs upon sharing. We’ll use this to track how many people come back to your content via links shared with AddThis. Highly recommended. Always global. | boolean | true |
pubid | Your AddThis profile ID. Always global to a page. | string | none |
services_compact | Services to use in the compact menu. For example, setting this to 'print,email,favorites' would result in only those three services appearing. Always global. |
string (csv) of service codes | We regularly optimize the default list based on our data. |
services_custom | Specify your own AddThis bookmarking service like so:
{name: "My Service", url: "http://share.example.com?url={{URL}}&title={{TITLE}}", icon: "http://example.com/icon.jpg"} . All three fields must be present for each custom service. Always global.Analytics will appear in your account under the service’s base domain name (no subdomains–“example.com” in this case), and the first service specified will appear in the compact menu unless |
array of custom service objects | none |
services_exclude | Services to exclude from all menus. For example, setting this to 'facebook,myspace' would hide Facebook and MySpace on all our menus. Always global. |
string (csv) of service codes | none |
services_expanded | Services to use in the expanded menu. Useful if very few services are desired — specifying a long list via services_exclude could be tiresome, and wouldn’t catch a new service added later. For example, setting this to 'bebo,misterwong,netvibes' would result in only those three services appearing in the expanded menu. Always global. |
string (csv) of service codes | all the services AddThis offers |
ui_508_compliant | If true , clicking the AddThis button will open a new window to a page supporting sharing without JavaScript. |
boolean | false |
ui_click | If true , the compact menu will never appear upon mousing over the regular button. Instead, it will be revealed upon clicking the button. |
boolean | false |
ui_delay | Delay, in milliseconds, before compact menu appears when mousing over a regular button. Capped at 500 ms. | integer | 0 |
ui_hover_direction | Normally, we show the compact menu in the direction of the user’s browser that has the most space (i.e., a button at the bottom of the page will pop up, and vice versa). You can override this behavior with this setting: 1 to force the menu to appear “up”, -1 to force the menu to appear “down”. |
integer | 0 |
ui_disable | If true , the compact menu will never appear upon mousing over or clicking on the regular button. Upon clicking, the expanded service menu will appear instead. |
boolean | false |
ui_email_from | This autofill the “from” address field in the email share service form. | string | none |
ui_email_note | This autofill the “note” address field in the email share service form. | string | none |
ui_email_to | This autofill the “to” address field in the email share service form. | string | none |
ui_language | For forcing the menu to use a particular language, specified via ISO code. For example, setting this to "sv" would show the menu in Swedish. Note: Regardless of the number of times it’s specified, only one language is supported per page. |
string | User’s browser |
ui_offset_left | Number of pixels to offset the left of the compact menu from its parent element | integer | 0 |
ui_offset_top | Number of pixels to offset the top of the compact menu from its parent element | integer | 0 |
ui_tabindex | Sets the global value of the tabindex for all AddThis buttons on the page. | integer | 1 |
Section 508 Compliance
You can make your AddThis button Section 508 compliant by using ui_508_compliant
.
<script type="text/javascript"> var addthis_config = { ui_508_compliant: true } </script> <a class="addthis_button"></a>