# Configuring X login and rich embeds for Discourse

**URL:** https://meta.discourse.org/t/configuring-x-login-and-rich-embeds-for-discourse/13395
**Category:** Integrations
**Tags:** sso, how-to, social-auth
**Created:** [March 4, 2014, 6:03pm UTC](https://meta.discourse.org/t/configuring-x-login-and-rich-embeds-for-discourse/13395 "2014-03-04T18:03:12Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [March 4, 2014, 6:03pm UTC](https://meta.discourse.org/t/configuring-x-login-and-rich-embeds-for-discourse/13395/1 "2014-03-04T18:03:12Z")

</div>

> 🔖 This guide explains how to set up Twitter login and rich embeds for your Discourse forum.
> 
> 🙋 Required user level: Administrator

⚠ In order for rich embeds to work properly, a Basic plan or higher for X Dev is mandatory. Rich embeds will not work with the Free X Dev plan.

## X Configuration

1. Go to the [Developer Portal](https://developer.twitter.com/en/portal/projects-and-apps) on X.

2. Choose between a Free, Basic, or Pro X Dev plan and complete the developer agreement and policy requirements.

3. After completing the agreement and policy requirements, you’ll be taken to the X dev dashboard.

## Create a new project

1. On your X Dev dashboard, click + Add Project.

2. Complete the requested information:

3. You will be shown your API Key and API Key Secret. Please write these down so you can add them to your Discourse forum later.

4. Click the App Settings button on the bottom right.

5. Scroll down to the User Authentication Settings section and click the Set up button. Update the following fields:

6. Click Save.

## Discourse configuration

1. Head over to your Discourse forum and enter the admin panel.

2. Click the Settings button and choose `Login` to find the Twitter-related settings:

3. Enable the `enable_twitter_logins` setting.

4. Copy and paste the API Key from X into the `twitter_consumer_key` setting.

5. Copy and Paste the API Key Secret from X into the `twitter_consumer_secret` setting.

6. Click the green checkmark to save the changes.

Users should now be able to log into your forum using their Twitter Account.

## Rich Embeds

The above steps also apply if you want to enable “rich embedding” which allows displaying tweets with their media (images video, etc). If you want rich embeds but don’t need Twitter login, simply uncheck `enable twitter logins` and leave the consumer key and secret intact.

> <https://twitter.com/discourse/status/1617652273383084032>

⚠ Rebaking or rebuilding HTML for posts with tweets will re-fetch those tweets, counting against your monthly tweet cap.

 ![Tweet cap](https://global.discourse-cdn.com/meta/original/4X/a/e/b/aeb9840b9646f1ea2db50bd33d882f062a0738c2.png)

## Additional resources

- [X Developer Platform - X](https://developer.x.com/en/docs/twitter-api/getting-started/about-twitter-api)
- [Twitter oneboxes now require Twitter credentials](https://meta.discourse.org/t/twitter-oneboxes-now-require-twitter-credentials/239398)

> Last edited by @sam 2026-03-18T04:43:33Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/configuring-x-login-and-rich-embeds-for-discourse/13395)._