X Feed (Twitter) by Smash Balloon
Settings
LicenseManage your plan and license key.
Your X Feed Pro license is Active
✓
Your X Feed Pro license is Inactive
Activate your key to enable Pro features, updates and support.
Your license key is expired
Renewing reactivates this key automatically. No need to re-enter it.
✕
You're on X Feed Lite
Free forever. No license key needed.
Have a license key?
Paste it here and we'll install Pro for you.
Get more with Pro
Hashtag, search and list feeds, video playback, moderation, and more. Lite users get 50% off, applied automatically at checkout.
ConnectionsHow this plugin talks to X.
Site KeyFree only
On the free plan, feeds fetch tweets through the shared Smash Balloon app using this key. Connect to get one; Refresh it if feeds stop updating.
X app
Connect your own X developer app (V2) to fetch directly from the X API instead of the shared app.
API Key
Called "Consumer Key" on the free plan.
API Key Secret
Access Token
Access Token Secret
Connected accountPro
Pro can connect an X account for feed retrieval, updated several times per day. Free sites update once per week. Connecting never lets the plugin manage the account.
Import / exportMove configuration between sites, and choose what survives an uninstall.
Preserve settings on uninstall
Keep all of your feeds and settings even if the plugin is uninstalled.
Import feed settings
Load a feed's configuration from a JSON file exported on another site.
Export feed settings
Download one feed's configuration as a JSON file.
PrivacyConsent, tracking & stored data.
GDPR
Only load images and videos from X's servers after visitors give consent. Automatic detects your consent plugin.
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.
CachingHow often feed data refreshes, and what gets stored between loads.
Caching schedulePro
How often feeds check X for new tweets in the background. Free sites update once a week automatically.
at
Daily source updates
Due to X API limits, the Smash Balloon relay allows up to 20 source updates per site per day.
14 of 20 used · resets 12:00 am
Persistent cache for search & hashtag feeds
Keeps up to 150 tweets per search or hashtag feed in the database, so tweets stay visible past X's 7-day search window. Repost and like counts stop updating.
Twitter Card cachePro
Cards are the rich previews shown for links in tweets. Reset if link previews look stale or wrong.
Clear all caches
Feed data is cached to keep your site fast. Clearing spends one daily update per source to pull fresh tweets right now.
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 locallyPro
Download videos and serve them from your server instead of streaming from X.
LoadingWhen and where feed assets load on the page.
Enqueue JS in headPro
Load plugin JavaScript in the <head> instead of the footer, for themes that need it.
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 ToProLabel on reply tweets | ||
| m / hTimestamp units, e.g. “12m”, “5h” | ||
| nowTimestamp for just-posted tweets | ||
| Thread text | ||
| Show ThreadProExpands a tweet thread | ||
| Hide ThreadProCollapses an expanded thread | ||
CodeSite-wide CSS and JavaScript added to every page with a feed.
Custom CSS
Applied wherever a feed renders. Only admins with the
unfiltered_html capability can save changes here.
Custom JS
Runs wherever a feed renders. Only admins with the
unfiltered_html capability can save changes here.
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.
Request method
How the plugin makes HTTP requests. Only change this if it can't connect to the X API.
Force cache to clear on schedule
Clears feed caches on a recurring schedule if your server keeps serving stale data.
DeprecatedOlder settings kept for compatibility. They still work today, but will be removed in a future update.
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 onlyPro
Fixes mixed-content warnings when Twitter Card links are non-HTTPS. Reset the card cache after enabling.
Use cURL for card retrievalPro
Force cURL when fetching Twitter Card data if the default transport fails.