Text Attachments

Updated: Jul 2, 2026

Copy for LLM

You can create posts with text attachments using the Threads API. Text attachments allow you to share long-form writing in a post or a reply with up to 10,000 characters and a link. They can also include emojis and style formatting.

Limitations

Text attachments can only be attached to text-only posts.

Text attachments cannot be attached to a post that has a poll.

If there is already a link attachment in the main post, a link attachment cannot be added in the text attachment.

The number of links is restricted to 5 or fewer.

Starting December 22, 2025, Threads posts containing more than 5 links will fail to post during the media creation step (POST /{threads-user-id}/threads) with the error code: THREADS_API__LINK_LIMIT_EXCEEDED.

How links are counted:

All unique URLs found in the text field are counted as links.

If the link_attachment_url field under the text_attachment field contains a URL that is different from all URLs in the text field, it is counted as an additional link.

If the link_attachment_url field under the text_attachment field is the same as any URL in the text field, it is only counted once, rather than twice.

Examples:

If the text field contains only www.facebook.com, and the link_attachment_url is also www.facebook.com, this counts as 1 link.

If the text field contains www.instagram.com and www.threads.com, and the link_attachment_url is www.facebook.com, this counts as 3 links.

If the text field contains www.example.com, www.example.com, and www.test.com, and the link_attachment_url is www.test.com, this counts as 2 links (www.example.com and www.test.com are each counted once).

If you receive this error, reduce the number of unique links in your post to 5 or less.

Create a post with a text attachment

Step 1: Create a Threads media container

You can add a text attachment to a post by making a request to the POST /{threads-user-id}/threads endpoint to create a media container with the text_attachment JSON object.

Parameters

Name	Description
`plaintext` string	Required. The text of the text attachment with a maximum of 10,000 characters.
`link_attachment_url` URL	Optional. The URL of a link to include in the text attachment.
`text_with_styling_info` string	Optional. The styling info be applied to the text and where it should appear. Values: `offset`, `length`, `styling_info` Note: The text styling info ranges within the `text_with_styling_info` field should not overlap. Available text styles: Bold Italic Highlight Underline Strikethrough

Example request

curl -i -X POST \
  -d "media_type=TEXT" \
  -d "text=<TEXT>" \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "text_attachment=
    {
      "plaintext": "Lengthy plain text for the text attachment.",
      "link_attachment_url": "<LINK_URL>",
      "text_with_styling_info":[
        {
          "offset": 0,
          "length": 7,
          "styling_info":["bold","italic"]
        },
        {
          "offset": 7,
          "length": 10,
          "styling_info":["highlight"]
        }]
    }" \
"https://graph.threads.com/v1.0/<THREADS_USER_ID>/threads"

Example response

{
  "id": "<THREADS_MEDIA_CONTAINER_ID>"
}

Step 2: Publish the media container

You can publish using the returned Threads media container ID to create your Threads post with a text attachment.

Retrieve posts with text attachments

Make a request to the GET /{threads-user-id}/threads or GET /{threads-media-id} endpoint with the text_attachment field to retrieve any media objects with text attachments.

Parameters

Name	Description
`text_attachment`	The text attachment for the post.

Example request

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  -d "fields=id,text_attachment" \
"https://graph.threads.com/v1.0/<THREADS_MEDIA_ID>

Example response

{
  "id": "<THREADS_MEDIA_ID>",
  "text_attachment": {
    "plaintext": "Lengthy plaintext for the text attachment.",
    "link_attachment_url": "<LINK_URL>",
    "text_with_styling_info": [
      {
        "offset": 0,
        "length": 7,
        "styling_info":["bold","italic"]
      },
      {
        "offset": 7,
        "length": 10,
        "styling_info":["highlight"]
      }]
  }
}

Learn more

Posts

Retrieve User Posts