Parameter reference

Tweet Button Parameter Reference

A Tweet button supports pre-populating share text, hashtags, and a Twitter account reference. Associate related Twitter accounts to drive followers.

Tweet content parameters

Parameter Description Example
text Pre-populated text highlighted in the Tweet composer. custom share text
url URL included with the Tweet. https://dev.twitter.com/web/tweet-button
hashtags A comma-separated list of hashtags to be appended to default Tweet text. example,demo
via Attribute the source of a Tweet to a Twitter username. twitterdev
related A comma-separated list of accounts related to the content of the shared URI. twitterapi,twitter


Button display parameters

Customize your displayed Tweet Button size, button alignment, and more.

These visual parameters do not apply to Web Intents, which are styled separately by implementing sites.

Parameter Description Example
size When set to large, display a larger version of the button. Set to l for iframe. large
lang A supported Twitter language code. es
dnt When set to true, the button and its embedded page on your site are not used for purposes that include personalized suggestions and personalized ads. true

HTML data-* example

      <a class="twitter-share-button"
  href="https://twitter.com/intent/tweet"
  data-size="large"
  data-text="custom share text"
  data-url="https://dev.twitter.com/web/tweet-button"
  data-hashtags="example,demo"
  data-via="twitterdev"
  data-related="twitterapi,twitter">
Tweet
</a>
    

 

JavaScript factory example

      twttr.widgets.createShareButton(
  "https:\/\/dev.twitter.com\/web\/tweet-button",
  document.getElementById("tweet-container"),
  {
    size: "large",
    text: "custom share text",
    hashtags: "example,demo",
    via: "twitterdev",
    related: "twitterapi,twitter"
  }
);