Skip to main content
The Post button is a small button displayed on your website to help viewers easily share your content on X. A Post button consists of two parts: a link to the Post composer on x.com and X for Websites JavaScript to enhance the link with the easily recognizable Post button. The publish.x.com website provides a simple, form-based approach to generate HTML markup for a Post button you may copy-and-paste into your website template. A post event is triggered on your webpage when the Post button is tapped or clicked.

​
How to add a Post button to your website

  1. Create a new anchor element with a twitter-share-button class to allow the X for Websites JavaScript to discover the element and enhance the link into a Post button. Set a href attribute value of https://x.com/intent/tweet to create a link to the X web intent composer.
<a class="twitter-share-button"
  href="https://x.com/intent/tweet">
Post</a>
  1. Pre-populate Post text and suggest related accounts by customizing Post web intent query parameters.
<a class="twitter-share-button"
  href="https://x.com/intent/tweet?text=Hello%20world">
Post</a>
  1. Customize Post button parameters using data-* attributes.
<a class="twitter-share-button"
  href="https://x.com/intent/tweet?text=Hello%20world"
  data-size="large">
Post</a>
  1. Asynchronously load the X for Websites JavaScript using our loading snippet. The JavaScript snippet will check for an existing version already on the page, initialize a function queue to be executed once the widgets JavaScript has loaded, and load the widgets JavaScript asynchronously from X’s CDN.

​
Post text components

​
text

A text parameter appears pre-selected in a Post composer. The Post author may easily remove the text with a single delete action. The text parameter may be auto-populated from the webpage’s <title> element if not explicitly set.

​
url

The url parameter contains an absolute HTTP or HTTPS URL to be shared on X. The shared URL will be automatically shortened in a published Post. A Card may appear for a shared URL. The url parameter may be auto-populated from a canonical link element (<link rel="canonical">) or the location.href of the page when not explicitly set. 
<link rel="canonical"
  href="/web/tweet-button">

​
hashtags

Add a comma-separated list of hashtags to a Post using the hashtags parameter. Omit a preceding “#” from each hashtag; the Post composer will automatically add the proper space-separated hashtag by language.

​
via

Attribute the source of a Post to a X username using the via parameter. The attribution will appear in a Post as ” via @username” translated into the language of the Post author. A via parameter may be auto-populated from a link or anchor element linked to a X profile page with a me relationship token. 
<link rel="me"
  href="https://x.com/XDevelopers"
>

​
Button customization

​
Size

Add a data-size attribute value of large to display a larger Post button.