Skip to content

Web Intents

Updated: Mar 19, 2026

Web intents offer a simple way for people to interact with Threads directly from your website, starting with the ability to quickly create posts and follow profiles.

When clicking on a Web intent URL, a new window opens and users are directed to Threads to complete the intended action. On mobile (iOS and Android), web intents will open the Threads app whenever it is installed. If they are not already logged-in, they will have the opportunity to sign in or create a Threads account.

When linking intents to an image, we recommend using the Threads logo available in our Threads Brand Resources⁠.

Post Intent

Post intents allow people to easily share their favorite content from your website directly to Threads, in order to increase your reach, spark conversations and drive traffic.

URL Format

The URL format is https://www.threads.com/intent/post⁠.

Supported Parameters

The post intent flow supports the following query string parameters.

NameDescription
textOptional. The text that the post dialog should be prefilled with.
urlOptional. The URL for an optional link attachment.
tagOptional. The topic tag that the post dialog should be prefilled with. Note: Newlines, tabs, periods (.), and ampersands (&) are not allowed in topic tags. The maximum length of a valid topic tag is 50 characters.
reply_controlOptional. The initial audience that is allowed to reply to a post. Values: everyone, accounts_you_follow, mentioned_only, followers_only
reply_post_shortcodeOptional. The shortcode of the parent post that you are replying to. When this parameter is included, it will open the Threads post composer in reply mode with the parent post visible.
quote_post_shortcodeOptional. The shortcode of the post that is being quoted. When this parameter is included, it will open the Threads post composer with the quoted post attached.

All parameter values should be encoded using percent-encoding⁠ ("URL encoding") so that the values can safely be passed via the URL.

Examples

ExampleURL
Only texthttps://www.threads.com/intent/post?text=Say+more+with+Threads+%E2%80%94+Instagram%27s+new+text+app⁠
Only link attachmenthttps://www.threads.com/intent/post?url=https%3A%2F%2Fabout.fb.com%2Fnews%2F2023%2F07%2Fintroducing-threads-new-app-text-sharing%2F⁠
Link attachment and texthttps://www.threads.com/intent/post?url=https%3A%2F%2Fabout.fb.com%2Fnews%2F2023%2F07%2Fintroducing-threads-new-app-text-sharing%2F&text=Introducing+Threads%3A+A+New+Way+to+Share+With+Text⁠
Only taghttps://www.threads.com/intent/post?tag=Threads⁠
Only reply audiencehttps://www.threads.com/intent/post?reply_control=followers_only⁠
Reply audience, tag, link attachment, and texthttps://www.threads.com/intent/post?reply_control=followers_only&tag=Threads&url=https%3A%2F%2Fabout.fb.com%2Fnews%2F2023%2F07%2Fintroducing-threads-new-app-text-sharing%2F&text=Introducing%20Threads%3A%20A%20New%20Way%20to%20Share%20With%20Text⁠
Reply post and texthttps://www.threads.com/intent/post?reply_post_shortcode=DRM8DF9AGUc&text=Threads%3A%20A%20New%20Way%20to%20Share%20With%20Text⁠
Quote post and texthttps://www.threads.com/intent/post?quote_post_shortcode=DPgzLZcAJPr&text=Threads%3A%20A%20New%20Way%20to%20Share%20With%20Text⁠
Reply post, quote post, and texthttps://www.threads.com/intent/post?reply_post_shortcode=DRM8DF9AGUc&quote_post_shortcode=DPgzLZcAJPr&text=Threads%3A%20A%20New%20Way%20to%20Share%20With%20Text⁠

Follow Intent

Follow intents allow people to easily follow a Threads account directly from your website.

URL Format

The URL format is https://www.threads.com/intent/follow⁠.

Supported Parameters

NameDescription
usernameRequired. The username of the user to follow.

Examples

ExampleURL
The official @threads accounthttps://www.threads.com/intent/follow?username=threads⁠

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About