Display a completely customizable, responsive and search engine crawlable X feed or Twitter feed on your website. The Custom Twitter Feeds plugin will display any user timeline posts or tweets that completely match the look and feel of your site and includes tons of customization options!
Features
Quick 3-Step Feed Creation – create a Twitter feed in just 3 steps with our guided flow to help you do this, even if you’re a WordPress newbie
Completely Customizable – by default, your user timeline feed will inherit your theme’s styles – automatically
X posts (Twitter feed) content is crawlable by search engines, adding SEO value to your site
Completely responsive and mobile-optimized – your Twitter feed looks great on any screen size and on any device
Easily display an X Feed (Twitter feed) from any Twitter user – you can quickly connect 1 public Twitter account for absolutely free
Using our Site Key and a verified email address, you can automatically refresh your Twitter feed once a week so you can showcase fresh Twitter content on your site at zero cost
Post caching means that your Twitter feed loads lightning fast.
Load more of your Tweets with the ‘Load More’ button
Built-in easy to use “Custom Twitter Feeds” Widget makes it easy to display tweets from any public Twitter account
Fully internationalized and translatable into any language
Display a beautiful header at the top of your Twitter feed
Enter your own custom CSS or JavaScript for even deeper customization of your Tweets
For simple step-by-step directions on how to set up the Custom Twitter Feeds plugin, please refer to our setup guide.
Benefits
Increase social engagement between you and your users, customers, or fans
Save time by using the Custom Twitter Feeds plugin to generate dynamic, search engine crawlable content on your website
Convert site visitors into Twitter followers by displaying your Twitter content directly on your site
Improve your SEO as all of that quality keyword-rich Twitter content is directly embedded into your website
Keep users on your site by showcasing your tweets from any user timeline on WordPress
Boost engagement by letting site visitors reply and like your tweets directly on your site
Showcase your Twitter content your way to perfectly match your website’s style
The Custom Twitter Feeds plugin is updated regularly with new features, bug-fixes and solutions to comply with recent Twitter API changes
Pro Version
In order to maintain the free version of Custom Twitter Feeds plugin on an ongoing basis, and to provide quick and effective support for free, we offer a Pro version of the plugin. The Pro version allows you to:
Display tweets from multiple users in the same Twitter feed
Display photos, videos, and gifs and view them in a popup lightbox directly on your site
Choose from professionally-made Twitter templates so you can easily build your Twitter feed in seconds
Allow filtering of Twitter user timelines include/exclude any/all keywords
Tweet-specific moderation system
Visual Twitter cards displayed with links which support them
Include Tweet replies (in reply to tweets)
Combine multiple Twitter feeds into one
Automatically update your Twitter feeds up to 12 times per day so you can effortlessly display up-to-date X posts (Twitter content) to your site visitors
“Great for Customization – Great plugin! Superb customization options! Am changing all twitter feeds for all my websites to this! I have tried several Twitter plugins so far. This is the best I have come across ????” – @nehavivekpatil
“Excellent plug-in. Excellent support. – Excellent instructions and guidance. Patient and prompt support for the newbies. Regular updates. You can’t lose. Thank you Smash Balloon.” – @nuspa
“Amazing Support and a Great Twitter Plugin – I am using the free version of this Twitter plugin and identified a real problem in the display on my website. I emailed support and Craig was all over the fix for me. Seven or so emails later (even on a Sunday) the problem was fixed and Craig was still reaching out to make sure all was well.“
In a world of crappy support for premium plugins, and even worse support for free plugins, this kind of support (and listening to customers) that Craig and Smash Balloon provided me make their premium products worth every penny. In fact, I am going to buy them for my next project. They deserve it.“
“At last a configurable Twitter Feed that WORKS! – I have messed with Twitter feeds on sites so many times only to be frustrated. This Plugin is the best I have tried. Stable, configurable and not too hefty a drag on performance. Well done!” – @mikemac67
“Everything you’ll need in a Twitter feed plugin – We’ve tried a few Twitter feed plugins across a bunch of our sites, and this one is now our go-to favorite. Most of the others we’ve tried have either styling or performance issues, but we’ve been using this plugin for a few months now, and it’s been perfect. There are tons of customization options, the feed looks great, and… it works!“
Kudos to the SmashBalloon team on a well supported, tightly developed, feature-packed WordPress Plugin.” – @laymanlab
View the reviews to see what other users are saying about the Custom Twitter Feeds plugin.
We’re dedicated to providing the most customizable, robust and well supported Twitter feed plugin in the world!
Feedback or Support
We’re committed to providing the easiest-to-use, most powerful and #1 supported Twitter feed plugin in the world, so if you have an issue or any feedback on how to improve the plugin, then please let us know.
If you like the plugin then please consider leaving a review, as it really helps to support the plugin. If you have an issue, then please allow us to help you fix it before leaving a review. Just let us know what the problem is and we’ll get back to you right away.
Can I display multiple Twitter feeds on my site or on the same page?
Yes, you can display multiple Twitter feeds by using our built-in shortcode options. For example: [custom-twitter-feeds screenname="smashballoon" num=3]. You can add it to any post, page, or widget to easily display your Twitter feed in a beautiful Twitter widget.
How do I embed the Twitter Feed directly into a WordPress page template?
You can embed your Twitter feed directly into a template file by using the WordPress do_shortcode function: <?php echo do_shortcode('[custom-twitter-feeds]'); ?>.
Is the content of my Twitter feed crawlable by search engines and how does it help improve my SEO?
Unlike other Twitter plugins which use iFrames to embed your Twitter feed into your page in a widget, the Custom Twitter Feeds plugin uses server-side code to embed your Twitter feed widget content directly into your page. This adds dynamic, search engine crawlable content to your site.
Will Custom Twitter Feeds work with W3 Total Cache or other caching plugins?
The Custom Twitter Feeds plugin should work in compatibility with most, if not all, caching plugins, but you may need to tweak the settings in order to allow the Twitter feed to update successfully and display your latest Twitter posts. If you are experiencing problems with your Twitter feed widget not updating then try disabling either ‘Page Caching’ or ‘Object Caching’ in W3 Total Cache (or any other similar caching plugin) to see whether that fixes the problem and the Twitter feed displays and updates successfully.
The font in my Twitter feed isn’t inherited from my website
By default, your Twitter feed should automatically inherit the font from your website. If this isn’t the case, then it’s possible that something in the theme is preventing this from happening. An issue that we’ve run into before is that <code> tags are added into the Twitter feed widget HTML by either the theme, another plugin, or perhaps even the custom-twitter-feeds shortcode being wrapped in code tags in your page editor.
To fix this:
1) First – go to your page editor, click on the ‘Text’ tab in the top right of the editor box, and check whether the [custom-twitter-feeds] shortcode is being wrapped in <code> tags, like so: <code>[custom-twitter-feeds]</code>. If it is, then remove them.
2) If this doesn’t solve the problem then try adding the following to the plugin’s “Custom CSS” section (Twitter Feeds > Customize > Custom CSS):
#ctf code { font-family: sans-serif; }
You can replace the font-family with whatever font your theme is using.
Can I display multiple Twitter feeds?
Twitter recently announced a Twitter API that offers a limited number of API requests for a $100 monthly fee. Right now, we’re working on integrating our plugin with this new API which would allow for more features.
If you’d like to display tweets from only one source, we’ve got your back. As a free user of Custom Twitter Feeds, you can showcase your tweets from 1 user timeline feed at NO cost to you.
Want to embed multiple Twitter feeds from different user timelines? This is a feature of the Pro version of the plugin, which allows you to show tweets from multiple user timelines, moderate and filter your feeds, and more!
Differences between the free version and Pro version of the Custom Twitter Feeds plugin
The main differences between the free version and Pro version of the Custom Twitter Feeds plugin are listed below. The extra features available in the Pro version are as follows:
Display photos, videos, and gifs in your Tweets, with support for 3rd party services such as YouTube, Vimeo, Vine, and SoundCloud
Show tweets from multiple users in the same Twitter feed
View Twitter media in a pop-up lightbox directly on your site
Display Tweets in a multi-column Masonry layout
Display your Twitter feed in rotating Carousels / Slideshows
Ready-made Twitter feed templates so you don’t have to build your feeds from scratch
Twitter Cards (rich, standout links) are displayed in Tweets for links that support them
Combine Twitter feeds of multiple user timelines
Update Twitter feeds and sources up to 12x per day
Filter feeds by keywords, or add/remove specific tweets manually
Tweet-specific moderation system
Autoload more tweets when scrolling to the bottom of the Twitter feed
Include Tweet replies (“in reply to”)
Try the Pro version demo here
I’m receiving an error message when trying to display my Twitter feed
If you receive an error message when trying to display your Twitter Feed widget then you can use the error reference below to diagnose the issue and find the relevant solution.
Twitter Error:
Unauthorized
Causes:
– You may not have connected your site to Smash Balloon or the connection is not valid – See #1 below
Twitter Error:
Unable to load tweets (with no other explanation)
Causes:
– You may need to raise the number of tweets to retrieve and display in your Twitter feed widget – See #3 below
Twitter Error:
Sorry, that Twitter page does not exist
Causes:
– There may be a typo in the Twitter screen name you are attempting to use
Twitter Error:
Over capacity
Causes:
– Twitter’s servers are over capacity so the API is unusable. This will correct itself after some time.
Twitter Error:
Connection timed out after 10000 milliseconds
Causes:
– Most likely this is due to your server blocking access to the Twitter API – See #4 below
Solutions
#1 – Your Smash Balloon connection might not be valid
You can reset or recollect your site access token by going to the Settings page for the Custom Twitter Feeds plugin and clicking the “Refresh” button to start the process of retrieving a new site key.
#2 – You have checked the box to use your own Twitter app information but one or more of the fields are incorrect
Note: Connecting you own Twitter App is not yet available but will be soon. All four fields, Twitter consumer token, Twitter consumer secret, Twitter access token, and Twitter access token secret, need to come from the Twitter app that you set up on Twitter.com. Try returning to your personal Twitter app management page https://apps.twitter.com/ and confirming that all four fields, Twitter consumer token, Twitter consumer secret, Twitter access token, and Twitter access token secret are entered correctly in the corresponding fields on the Custom Twitter Feeds plugin’s “Configure” tab.
#3 – You may need to raise the number of tweets to retrieve
Navigate to the type of Twitter feed you are trying to display on twitter.com. For example, if you are displaying a Twitter feed from the screenname “smashballoon”, go to https://twitter.com/smashballoon. Make sure there are tweets visible. Then click on the link “Tweets & replies”. If there are a more recent replies than original tweets, there may be too many tweets being filtered out to display any. Twitter replies are removed by default. You can raise the number of tweets to retrieve initially by going to the Custom Twitter Feed Settings page, “Customize” tab, and navigating to the “Advanced” area. Then raise the “Tweet Multiplier” and test to see if your Twitter feed now displays tweets.
If you’re still having trouble displaying your Tweets after trying the common issues above, then please contact support for assistance.
Tweak: Removed CtfDateTime class as PHP 5.2 and lower is no longer supported.
Fix: Plugin hardening.
2.2.1
New: Added translation files for German, Spanish, Italian and more.
Tweak: Allowed the plugin to retry updating the feed in the event of an issue preventing it from updating.
Fix: Removed unused code.
2.2
New: Added support for using your own Twitter App. Go to the “Settings” page, “Twitter Integration” area.
New: Added a setting to rebrand your Twitter feeds to “X”. Go to the “Settings” page, “Advanced” tab to enable the branding change.
Fix: Added a workaround in the event cron is broken so feeds will continue to update.
2.1.2
Fix: Fixed text causing confusions about what features are available.
2.1.1
Fix: Fixed a PHP error occurring in sites using PHP 7.4 or lower.
2.1
Important: We are launching our new Twitter solution for our free users! This will require you to connect to Smash Balloon by verifying an email address and receiving a special site token that can be used to update a single feed. See our website for information about how the new system works.
Important: Due to the higher costs for updating feeds, our free users will be limited to one feed that is updated once a week. For more updates and more feeds, consider upgrading to Pro.
2.0.7
Update: We are working on a solution for our free users to see an updated feed. See this page for more information. Thank you for your patience while we continue to fight for your success with our plugin!
2.0.6
Fix: Fixed a conflict with Autoptimize that would cause a PHP error when clearing the Twitter cache.
Fix: Fixed a PHP notice that would occur when bulk deleting feeds.
Fix: When using the “boxed” layout, there would be no space between the header and the first tweet in the list.
2.0.5
Tweak: API calls are prevented in the event that the Twitter API returns an error.
Fix: The feature for using your own Twitter App credentials was not working.
2.0.4
Fix: Enabling the setting “AJAX theme loading fix” would cause the feed customizer to not load.
Fix: Removed HTML comments from the feed templates.
2.0.3
Fix: For GDPR plugins that Custom Twitter Feeds integrates with, other plugins that also integrate with those GDPR plugins would not work properly when Custom Twitter Feeds was active.
2.0.2
Fix: Added code to help with debugging issues.
Fix: The descriptions of feed types were incorrect.
2.0.1
Fix: When GDPR features were active, avatars would not display even after consent had been given.
Fix: Fixed a PHP error that would occur with specific kinds of tweets being displayed.
Fix: Not all data was cleared after uninstalling the plugin.
2.0
Important: Minimum supported WordPress version has been raised from 3.5 to 4.1.
New: Our biggest update ever! We’ve completely redesigned the plugin settings from head to toe to make it easier to create, manage, and customize your Twitter feeds.
New: All your feeds are now displayed in one place on the “All Feeds” page. This shows a list of any existing (legacy) feeds and any new ones that you create. Note: If you updated from a version prior to v1.8 then you may need to view your feeds on your webpage so that the plugin can locate them and list them here.
New: Easily edit individual feed settings for new feeds instead of cumbersome shortcode options.
New: It’s now much easier to create feeds. Just click “Add New”, select your feed type, connect your account, and you’re done!
New: Brand new feed customizer. We’ve completely redesigned feed customization from the ground up, reorganizing the settings to make them easier to find.
New: Live Feed Preview. You can now see changes you make to your feeds in real time, right in the settings page. Easily preview them on desktop, tablet, and mobile sizes.
New: Color Scheme option. It’s now easier than ever to change colors across your feed without needing to adjust individual color settings. Just set a color scheme to effortlessly change colors across your entire feed.
New: You can now change the number of columns in your feed across desktop, tablet, and mobile.
New: Easily import and export feed settings to make it simple to move feeds across sites.
1.8.4
Tweak: When clearing the Twitter cache, caches from common page caching solutions are now also cleared.
Tweak: Changed capability check from ‘edit_posts’ to ‘manage_custom_twitter_feeds’ when clearing the Twitter cache using AJAX.
Tweak: An alert bubble is added to the Twitter Feeds menu item when there are new notifications available.
1.8.3
Tweak: Added “noopener” attribute to hasthags and account tags linked in tweets.
Fix: Fixed a compatibility issue with the Complianz Cookie Consent plugin integration.
Fix: Fixed a compatibility issue with the Web Toffee GDPR Cookie Consent plugin integration.
Fix: Bio text was missing from the header even when this feature was enabled.
1.8.2
Tested with WordPress 5.8 update.
Fix: “Display your feed” tab was showing the wrong shortcode for the “layout” setting available in the pro version.
Fix: Fixed an issue with GDPR Cookie Consent by Web Toffee integration.
1.8.1
Fix: Fixed several issues with GDPR Cookie Consent by Web Toffee integration.
New: The locations of the Twitter feeds on your site will now be logged and listed on a single page for easier management. After this feature has been active for awhile, a “Feed Finder” link will appear next to the Feed Type setting on the plugin Settings page which allows you to see a list of all feeds on your site along with their locations.
New: Added support for WordPress based translations using language files.
Tweak: Changed the default method of retrieving posts to use the WP_HTTP class.
Fix: Updated jQuery methods for compatibility with WordPress 5.7.
1.7
New: Integrations with popular GDPR cookie consent solutions added: Cookie Notice by dFactory, GDPR Cookie Consent by WebToffee, Cookiebot by Cybot A/S, Complianz by Really Simple Plugins, and Borlabs Cookie by Borlabs. Visit the Twitter Feed settings page, Customize tab, Advanced section for more information.
Tweak: Icon font support was discontinued. Only SVGs will be used for icons in feeds.
Tweak: Twitter Intents JS updated to the latest version.
1.6.1
Tweak: Added support for improved dashboard notices on the plugin settings page.
Tweak: HTML attribute rel=”noopener noreferrer” added to all outbound links for extra security.
Fix: Fixed PHP warning “non-numeric value encountered” when setting the tweet multiplier option to something that wasn’t a number.
1.6
New: Updated icons in the feed to match Twitter.
Tweak: Several CSS changes to make the Twitter feed text responsive with more themes.
Fix: Removed debugging code causing issue when saving settings on the “Customize” tab.
1.5.1
New: To help us improve the plugin we have added usage tracking so that we can understand what features and settings are being used, and which features matter to you the most. The plugin will send a report in the background once per week with your plugin settings and basic information about your website environment. No personal or sensitive data is collected (such as email addresses, Twitter account information, license keys, etc). You can opt-out by simply disabling the setting at: Twitter Feed > Customize > Misc > Enable Usage Tracking. See here for more information.
Tweak: When a feed is from a Twitter account that has a lot of reply tweets, the plugin will collect more tweets initially for better performance.
Tweak: Hashtag feeds have retweets filtered out by default for improved feed performance.
Fix: Several strings updated to be translatable.
1.5
New: Added a “Twitter Feeds” Gutenberg block to use in the block editor, allowing you to easily add a Twitter feed to posts and pages.
Tweak: Added function ctf_init() to easily rerun JavaScript for the plugin.
Tweak: Non Twitter Feeds admin notices are removed when viewing settings pages for Custom Twitter Feeds.
1.4.1
Tweak: Added aria-label attributes to SVG icons for improved accessibility.
Fix: Fixed PHP warning that occurred when a URL in the tweet text did not have a full length URL available from the Twitter API.
Fix: Using the setting to link the tweet text to Twitter would cause nested links and invalid HTML.
Fix: Fixed Twitter logo not displaying if avatar, author, and date were hidden.
1.4
New: Twitter logo added to the top right of each tweet to fit with Twitter’s display guidelines. Customize the logo on the “Style” tab, “Author” area or hide it using the settings at Twitter Feeds > Customize > Show/Hide.
New: Minified versions of JavaScript and CSS files now used.
New: JavaScript file added to the source of the page only when the Custom Twitter Feeds shortcode is used on the page.
New: SVGs used for icons instead of Font Awesome font file. You can switch back to using the Font Awesome font file using the setting at Twitter Feeds > Customize > Advanced.
New: Tweets that are replies to the same Twitter account or mention the same account can be included in the Twitter feed widget by enabling the setting “Always include replies to self in the feed”.
New: Added a setting to completely disable Twitter intents widget.js file.
Tweak: The HTML element used for icons has been switched from “i” to “span” for better accessibility.
Tweak: Changed styling of Twitter media placeholder icons.
Tweak: Combined widgets.js file with native JavaScript file for the plugin.
Tweak: Twitter widgets.js will only be enqueued when “actions” are included in the Twitter feed.
Tweak: Tweet text line height style set to 1.4.
Fix: Bio text not displaying in header even when enabled.
1.3
New: You can now choose to only display a certain amount of text characters in the Tweets in your Twitter widget, with a clickable link to display the rest. This is set to be 280 characters by default, but can be changed by using the following setting: Twitter Feeds > Customize > Style > Tweet Text > Text Length, or by using the “textlength” shortcode setting.
Tweak: Twitter intents JavaScript not loaded on the page if tweet actions are removed
