Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Post content parameters

ParameterDescriptionExample
textPre-populated text highlighted in the Post composer.custom share text
urlURL included with the Post.https://dev.x.com/web/post-button
hashtagsA comma-separated list of hashtags to be appended to default Post text.example,demo
viaAttribute the source of a Post to a X username.xdevelopers
relatedA comma-separated list of accounts related to the content of the shared URI.xapi,x

​
Button display parameters

Customize your displayed Post Button size, button alignment, and more. These visual parameters do not apply to Web Intents, which are styled separately by implementing sites.
ParameterDescriptionExample
sizeWhen set to large, display a larger version of the button. Set to l for iframe.large
langA supported X language code.es
dntWhen 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://x.com/intent/tweet"
  data-size="large"
  data-text="custom share text"
  data-url="https://dev.x.com/web/tweet-button"
  data-hashtags="example,demo"
  data-via="xdevelopers"
  data-related="xapi,x">
Post
</a>

​
JavaScript factory example

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