Getting Started Guide

Getting Started with Cards

1. How to create a Twitter account. Sign up on Twitter.; Customize your profile, including picking a profile photo and header.; Add a bio. Set up your timeline by following people.; Tweet!; Tips for picking a username. Your username, also known as a 'handle', is the name your followers use when sending replies, mentions, and Direct Messages.; It will also form the URL of your Twitter profile page.
2. The most powerful Twitter tool for real-time tracking, organizing, and engagement. Reach your audiences and discover the best of Twitter.
3. Twitter has been built on open source since the beginning. Openness is part of our DNA. The projects you see here were born at Twitter, and patches are always welcome!
4. Follow your interests. ⭐ Tweet, Fleet, Retweet, Reply to Tweets, Share or Like - Twitter is the #1 social media app for latest news & updates. Tap into what’s going on around you. Search hashtags and trending topics to stay updated on your friends & other Twitter followers. Follow the tweets of your favorite influencers, alongside hundreds.

To get started with implementing Cards markup, specify the type of card for your content by adding the following HTML markup to the HEAD section of the page:

Card properties are simple key-value pairs, each defined in an HTML meta tag as seen above. The combined collection of properties defines the overall card experience on Twitter, and each card type supports and requires a specific set of properties.

Twitter API v2: Early Access. We’re building a new Twitter API with a modern and more sustainable foundation as well as an improved developer experience. Early Access is now available, which enable you to listen to, analyze, and control the conversation on Twitter. Additional endpoints, features, and access levels will be released soon!

All cards have one basic property in common - the card type value:

Only one card type per-page is supported. If more than one twitter:card value exists in the page, the “last” one in sequence will take priority.

Card and Content Attribution

Each card has built-in content attribution, which surfaces appropriate Twitter accounts for the content as specified by you. Users will be able to follow and view the profiles of attributed accounts directly from the card. There are two kinds of attribution:

Website Attribution: Indicates the Twitter account for the website or platform on which the content was published. Note that a service may set separate Twitter accounts for different pages/sections of their website, and the most appropriate Twitter account should be used to provide the best context for the user. For example, nytimes.com may set the the website attribution to “@nytimes” for front page articles, and “@NYTArts” for articles in the Arts & Entertainment section.

Creator Attribution: Indicates the individual user that created the content within the card. This applies to the Summary with Large Image card.

Configure card attribution using the following properties:

URL Crawling & Caching

Twitter’s crawler respects Google’s robots.txt specification when scanning URLs. If a page with card markup is blocked, no card will be shown. If an image URL is blocked, no thumbnail or photo will be shown.

Twitter uses the User-Agent of Twitterbot (with version, such as Twitterbot/1.0), which can be used to create an exception in the robots.txt file.

For example, here is a robots.txt which disallows crawling for all robots, except Twitter’s fetcher:

Here is another example, which specifies which directories are allowed to be crawled by Twitterbot (in this case, disallowing all except the images and archives directories):

The server’s robots.txt file must be saved as plain text with ASCII character encoding. To verify this, run the following command:

Content is cached by Twitter for 7 days after a link to a page with card markup has been published in a Tweet.

If you encounter issues with cards in Tweets not appearing properly, see the Cards Troubleshooting Guide.

Card Display

Twitter Cards generated from meta tags only appear when a Tweet is either expanded in the timeline (on web) or viewed on the Tweet’s individual permalink page (by clicking on the date from the timeline, either on web or on mobile).

In limited circumstances, Cards may appear in the timeline, such as in images posted to Twitter, Ad formats, and Twitter-run experiments.

If you are looking to bring media (photos, videos and Cards) into the timeline, consider one of the following options:

• Accounts can pin a Tweet to the top of their timeline, which auto-expands the Tweet and displays the Card. (This is possible on web only.).
• For photos and animated GIFs, upload the media directly with the Tweet or consider using the Twitter API to upload media.
• For Ad formats with a call-to-action, visit Twitter Ads for Website Cards.

Multiple URLs in a Tweet

In some circumstances, users may want to Tweet multiple URLs. Only one card may be shown in a Tweet. Here is the order of precedence when processing multiple URLs:

1. Images or media attached to Tweets will have precedence over any card attached to a URL.
2. URLs with cards are processed in order of appearance in the Tweet, first to last

Twitter Cards and Open Graph

Open Twitter Browser

Twitter card tags look similar to Open Graph tags, and are based on the same conventions as the Open Graph protocol. When using Open Graph protocol to describe data on a page, it is easy to generate a Twitter card without duplicating tags and data. When the Twitter card processor looks for tags on a page, it first checks for the Twitter-specific property, and if not present, falls back to the supported Open Graph property. This allows for both to be defined on the page independently, and minimizes the amount of duplicate markup required to describe content and experience.

Note that while Open Graph recommends specifying the “og” RDFa Core 1.1 CURIE prefix mapping via <html prefix='og: http://ogp.me/ns#'>, no such markup is required for Twitter cards and its use of the twitter: prefix in a HTML meta element’s name attribute. Open Graph protocol also specifies the use of property and content attributes for markup (<meta property='og:image'/>) while Twitter cards use name and content. Twitter’s parser will fall back to using property and content, so there is no need to modify existing Open Graph protocol markup if it already exists.

The example below uses a mix of Twitter and Open Graph tags to define a summary card:

I cannot remember the username I used.

Open Twitter Links In Chrome

• Use your account email address and password to log into Twitter.
  • If your password is not working, request a new password by entering your email address in our reset form.
  • If our system cannot find your email address, you may be entering the wrong one. Keep reading.

Open Twitter Meme Trollface

I cannot remember the email address I used on my account.

• Use your account's username and password to log into Twitter.
  • If that does not work, visit our password request form and enter the username or email addresses or mobile phone number you think you used. Then, check all your email inboxes – we will send password reset instructions to the account's email address.

I cannot remember the phone number I used on my account.

• If you are prompted to enter a mobile phone number when requesting a password reset, and cannot remember what phone number you used, enter your username or account email address.

I think my account has been hacked!

Open Twitter App

• See our 'hacked' help page for next steps, including a quick way to contact us for assistance.