X Feed (Twitter) by Smash Balloon
Settings
License KeyYour license key provides access to updates and support
Your X Feed Pro license is Active!
✓
Your X Feed Pro license is Inactive!
Your X Feed Pro license is Expired!
✕
The license expired on August 02, 2026. Please renew it and try again. Renew
You are using the Lite version of the plugin–no license needed. Enjoy! 🙂 To unlock more features, consider Upgrading to Pro.
As a valued user of our Lite plugin, you receive 50% OFF - automatically applied at checkout!
Already purchased? Simply enter your license key below to activate X Feed Pro.
AI Agents
Works through WPVibe, a free plugin you install once.
Works through WPVibe, a free plugin you install once.
Works through WPVibe, a free plugin you install once.
Couldn’t install WPVibe. Install it from the Plugins screen instead.
Connect Claude, ChatGPT, Cursor or any MCP client in WPVibe.
MCP Write Access
This will allow your AI agent to make changes to X Feed.
ConnectionsHow this plugin talks to X.
Site Key
Feeds fetch tweets through the shared Smash Balloon app using this key. Refresh it if feeds stop updating.
Import / exportMove feeds between sites as JSON files.
Import a feed
Add a feed from a file exported on another site.
Export a feed
Download a feed's settings to import on another site.
Preserve settings on uninstall
Keep all of your feeds and settings even if the plugin is uninstalled.
PrivacyConsent, tracking & stored data.
GDPR
Only load images and videos from X's servers after visitors give consent. Automatic detects your consent plugin. See what GDPR mode changes in X Feed
Install WPConsent for GDPR
Manage cookie banners and visitor preferences from a single place. Smash Balloon plugins work great with WPConsent.
Usage tracking
Share anonymous usage data to help us improve the plugin.
Delete all platform data
Permanently removes every tweet, image, connected account and access token this plugin has stored.
Feed updatesHow often feeds pull new tweets from X, and what that costs.
Check for new posts
X API limits how often free feeds can update. Next check at 2:00 am Thursday
Every 3 days
Check for new posts
Each check spends one daily update per source.
at
6 of 15 daily updates used · resets 12:00 am
Refresh feeds now
Pulls fresh tweets right away. Spends one daily update per source. Formerly “Clear All Caches.”
Pulls fresh tweets right away. Formerly “Clear All Caches.”
Check for new posts more often with X Feed Pro
Stored dataWhat the plugin keeps in your database between checks.
Keep search & hashtag tweets past 7 days
X only returns 7 days of search results. Keeps up to 150 tweets per feed so older ones stay visible. Repost and like counts stop updating.
Link previews
The rich preview shown under links in tweets. Refresh if they look stale or wrong.
MediaHow images and video are stored and sized.
Image optimization
Stores local copies of images in several sizes so feeds load the smallest one that fits.
Auto-detect image resolution
Pick the image size that matches how large it renders on the page. When off, images load at full resolution.
Cache videos locally
Download videos and serve them from your server instead of streaming from X.
Scripts and stylesWhere the plugin’s JavaScript and CSS load. The defaults suit most themes.
Load script in the page head
Puts the feed script in <head> on every page instead of the footer of feed pages. Only for themes that run scripts early or inject content with AJAX.
AppearanceHow feeds look and what branding they carry.
Use X branding
Show the X logo and wording across the plugin and your feeds. Turn off to keep the legacy Twitter bird and names.
Custom templates
Use HTML templates from your theme folder instead of the built-in feed markup.
Show credit link
Display a small "Powered by Smash Balloon" link under feeds.
InteractionsWhat visitors can do without leaving the page.
Reply, repost and like buttons
Uses X's intent JavaScript so visitors can reply to, repost and like tweets without leaving your site.
TranslationsThe words feeds show. Empty fields use the English defaults.
| Default text | Your translation | |
|---|---|---|
| Load MoreButton under the feed | ||
| RepostsLabel on reposted tweets (“Retweeted” with legacy branding) | ||
| In Reply ToLabel on reply tweets | ||
| m / hTimestamp units, e.g. “12m”, “5h” | ||
| nowTimestamp for just-posted tweets | ||
| Thread text | ||
| Show ThreadExpands a tweet thread | ||
| Hide ThreadCollapses an expanded thread | ||
CodeSite-wide CSS and JS for feeds live in WPCode snippets.
Install WPCode for custom code
Add custom CSS and JavaScript for your feeds as managed snippets. Ready-made Smash Balloon snippets appear here once WPCode is active.
TroubleshootingCompatibility workarounds for themes and hosts that need them.
AJAX theme loading fix
Workaround for themes that load content with AJAX and skip feed scripts.
DeprecatedThese settings are going away. Saved values keep working until they’re removed, but can no longer be changed.
Request method
How the plugin makes HTTP requests. Only change this if it can't connect to the X API.
Check for new tweets on page load
The old page-load caching mode. Background updates replaced it; kept for feeds that still depend on it.
Cache duration
How long cached tweets are reused before the next page-load check.
for
HTTPS images only
Fixes mixed-content warnings when link previews point at non-HTTPS images. Refresh link previews after enabling.
Use cURL for card retrieval
Force cURL when fetching Twitter Card data if the default transport fails.
Force cache to clear on schedule
Clears feed caches on a recurring schedule if your server keeps serving stale data.
X app
Connect your own X developer app (V2) to fetch directly from the X API instead of the shared app.
API Key
From your app's Keys and tokens page in the X developer portal.
API Key Secret
Access Token
Access Token Secret
Custom CSS
CSS added to every feed page. For new styles, use WPCode snippets under Customization → Code.
Custom JS
JavaScript added to every feed page. For new code, use WPCode snippets under Customization → Code.
Custom code now lives in WPCode snippets. Install WPCode