Docs    Twitter    Getting Started

Setting up the Custom X (formerly Twitter) Feeds Pro WordPress Plugin

How to download, install and set up the Custom X (formerly Twitter) Feeds Pro WordPress plugin, and find your licence key.

Would you like to show posts from an X (formerly Twitter) account on your WordPress site with the paid version of Custom Twitter Feeds?

In this guide, we’ll walk you through installing the plugin, activating your license key, creating your feed, and adding it to your site. All you need is your Custom Twitter Feeds purchase and access to your WordPress dashboard.

Note: Using the free version of Custom Twitter Feeds? See our guide on setting up the free version.

Downloading the Plugin

To get started, we’ll download the plugin file. The plugin’s menus and screens still use the name Twitter. That’s the name you’ll see in these steps.

After your purchase, log in to your Smash Balloon account and open the Downloads tab. Then, click the download link for Custom Twitter Feeds Pro to save the plugin’s .zip file to your computer.

We also email your download link and license key to the address you used at checkout.

There’s no need to unzip the file. You’ll upload the .zip file to WordPress as it is.

Note: Safari can unzip files on its own after it downloads them. In Safari’s settings, open the General tab and uncheck the option to open safe files after downloading. Then, download the plugin again.

With the .zip file saved to your computer, the next step depends on whether your site already runs the free version.

Switching From the Free Version

If you already use the free version of Custom Twitter Feeds, a few quick steps get it ready for the switch. Both versions use the same feeds and settings. The paid version picks up your feeds as they are.

New to Custom Twitter Feeds? In that case, skip ahead to Installing the Plugin.

First, go to Twitter Feeds » Settings in your WordPress dashboard.

The WordPress dashboard menu with Twitter Feeds » Settings highlighted and the free version's Settings page open

On the General tab, scroll down to Preserve settings if plugin is removed. It’s off by default, so the free version cleans up its feeds and settings when you delete it.

Since you’ll delete the free version later, click the toggle to turn it on. This keeps your feeds and settings saved for the paid version.

The Preserve settings if plugin is removed setting with its toggle turned on and an arrow pointing at the toggle

At the bottom of the page, click Save Changes.

The bottom of the free version's Settings page with an arrow pointing at the Save Changes button

Next, go to Plugins » Installed Plugins. The paid version won’t activate while the free version is active. Under Smash Balloon X (Twitter) Feed, click Deactivate.

The WordPress dashboard menu with Plugins » Installed Plugins highlighted and an arrow pointing at the Deactivate link under Smash Balloon X (Twitter) Feed

A window opens and asks why you’re deactivating the plugin. It’s a feedback survey for Smash Balloon. The plugin deactivates the same way whichever reason you pick.

In that window, pick the reason that fits best. Then, click Deactivate Plugin.

The Reason for Cancellation window with a list of reasons and an arrow pointing at the Deactivate Plugin button

Now that the free version is deactivated, you’re ready to install the paid version.

Installing the Plugin

You’ll install the paid version by uploading the .zip file you downloaded.

In your WordPress dashboard, go to Plugins » Add Plugin. At the top of the page, click Upload Plugin.

The WordPress dashboard menu with Plugins » Add Plugin highlighted and an arrow pointing at the Upload Plugin button

In the upload box, click Choose File and select the .zip file you downloaded.

The plugin upload box with an arrow pointing at the Choose File button

Once your file shows next to the button, click Install Now.

The plugin upload box with the plugin's .zip file chosen and an arrow pointing at the Install Now button

WordPress uploads and installs the plugin. When it’s done, click Activate Plugin.

The Plugin installed successfully message with an arrow pointing at the Activate Plugin button

With the plugin installed and active, you’re ready to add your license key.

Activating Your License Key

Your license key gives you access to plugin updates and support.

From your WordPress dashboard, go to Twitter Feed » Settings. The paid version’s menu reads Twitter Feed. The free version’s menu reads Twitter Feeds.

The WordPress dashboard menu with Twitter Feed » Settings highlighted and the General tab of the Settings page open

On the General tab, find the License Key box. It says that your Twitter Feed Pro license is Inactive until you activate your key. Next, paste the license key from your purchase email into the field and click Activate.

Note: Does the License Key box say “You are using the Lite version of the plugin”? In that case, your site is still running the free version. To switch, go to Plugins » Installed Plugins, deactivate Smash Balloon X (Twitter) Feed, and activate Custom Twitter Feeds Pro. If you don’t see the paid version there, follow the steps in Installing the Plugin.

The License Key box with a key in the field, the message that the license is Inactive, and an arrow pointing at the Activate button

Once your license is active, the License Key box says that your Twitter Feed Pro license is Active. The button next to the field now reads Deactivate.

The License Key box with the message that the Twitter Feed Pro license is Active and the Deactivate button

Your license is now active. If you switched from the free version, you can delete it next. If not, skip ahead to Creating Your Feed.

Deleting the Free Version

With the paid version active, you no longer need the free version. Since you turned on Preserve settings earlier, your feeds and settings stay in place when you delete it.

Note: Skipped the Preserve settings step? The paid version has the same setting on the General tab of Twitter Feed » Settings. In that case, turn it on and click Save Changes before you delete the free version.

On the Plugins page, find Smash Balloon X (Twitter) Feed and click Delete. Your browser then asks if you want to delete the plugin and its data. With Preserve settings on, your feeds and settings stay in place. To continue, click OK.

The WordPress Plugins page with Custom Twitter Feeds Pro active and an arrow pointing at the Delete link under Smash Balloon X (Twitter) Feed

The free version is now deleted. You’re ready to create your feed.

Creating Your Feed

Your feed starts with the X account you want to show.

From your WordPress dashboard, go to Twitter Feed » All Feeds. Then, click Add New.

The WordPress dashboard menu with Twitter Feed » All Feeds highlighted and an arrow pointing at the Add New button

On the Select Feed Type step, we’ll keep User Timeline selected for this guide. This type shows the posts from one or more accounts. To continue, click Next.

The other feed types depend on your license level. Hashtag feeds need the plus license level or higher. Search and Lists feeds need the elite license level.

The Select Feed Type step with User Timeline selected and an arrow pointing at the Next button

In the User Timeline box, type the handle of the X account you want to show, like @smashballoon. You can type it with or without the @. To add more than one account, separate the handles with commas. After that, click Next.

The User Timeline box with the handle smashballoon typed in and an arrow pointing at the Next button

If your license level includes templates, the next step asks you to start with a template. The Default template is already selected, and you can change it later. To continue, click Next. On the basic license level, the plugin skips this step.

The Start with a template step with the Default template selected and an arrow pointing at the Next button

The plugin creates your feed and opens it in the feed customizer. The first time it opens, a short tour points out the Embed button. You can follow it or close it.

On the Customize tab, you can change your feed’s template, layout, and colors. The preview on the right shows how your feed looks. When you’re happy with it, click Save.

The feed customizer showing the Customize tab and a preview of the feed with an arrow pointing at the Save button

Your feed is saved. Next, we’ll look at keeping individual posts out of it.

Hiding Specific Posts

If a post shows up in your feed that you don’t want on your site, you can hide it with its ID.

You’ll find a post’s ID at the end of its URL on X. In https://x.com/smashballoon/status/2110154381178102086, the ID is 2110154381178102086.

In the feed customizer, open the Settings tab. Then, click Filters.

The Settings tab of the feed customizer with an arrow pointing at Filters

Next, scroll down to Hide specific tweets and enter the post’s ID in the field. To hide more than one post, separate the IDs with commas.

The Hide specific tweets field with a post ID typed in and an arrow pointing at the field

After that, click Save. The post leaves your feed once you save. To show it again, remove its ID from the field and click Save.

Note: Hashtag and Search feeds may show promoted posts that don’t fit your feed settings. You can remove those with the same filters.

The top of the feed customizer with an arrow pointing at the Save button

To learn more, see our guide on hiding specific posts.

Once your feed hides the posts you don’t want, you’re ready to add it to your site.

Embedding the Feed

You can add your feed with a block, with a shortcode, or directly in a theme template.

Using the Block

First, open the page or post where you want your feed in the WordPress editor. Then, open the block inserter and search for Twitter. In the results, click the Twitter Feed block.

The WordPress block inserter searching for Twitter with an arrow pointing at the Twitter Feed block

Next, choose your feed from the Select a Feed list in the block’s settings. After that, publish or update your page.

The Twitter Feed block settings with an arrow pointing at the Select a Feed list

Your feed now shows on that page.

A published page titled Latest Posts showing the feed with the Smash Balloon header and a post from @smashballoon

Next, we’ll look at adding it with a shortcode instead.

Using the Shortcode

You can also add your feed anywhere that accepts a shortcode. In the feed customizer, click Embed.

The top of the feed customizer with an arrow pointing at the Embed button

The Embed Feed window shows the shortcode for your feed. It looks like [custom-twitter-feeds feed=1]. To use it, click Copy. Then, paste the shortcode into any page, post, or widget.

The Embed Feed window showing the feed's shortcode with an arrow pointing at the Copy button

For more help, see How to Add a Shortcode in WordPress for a step-by-step guide.

If you want your feed in a spot the editor can’t reach, a theme template is the next option.

Adding the Feed to a Theme Template

A theme template shows your feed in a spot the WordPress editor can’t reach, like your site’s footer. This option involves editing your theme’s PHP files. It’s best suited to developers.

To do this, add the WordPress do_shortcode function to your template file where you want the feed:

<?php echo do_shortcode( '[custom-twitter-feeds feed=1]' ); ?>

Then, replace the 1 with your feed’s number. You’ll find it in the shortcode from the Embed Feed window.

Your feed is now on your site. Next, we’ll look at how to change it later.

Editing Your Feed

You can come back and change your feed at any time.

To do that, go to Twitter Feed » All Feeds. Then, click the Edit button next to your feed. It shows a pencil icon.

The All Feeds list with the smashballoon feed and an arrow pointing at the Edit button

That’s it! You’ve installed the paid version of Custom Twitter Feeds, activated your license key, and added your feed to your site.

Next, see our guide on the X (formerly Twitter) changes to learn how often your feed updates on each license level.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about setting up the paid version of Custom Twitter Feeds.

Why does WordPress ask me to deactivate the free version first?

The paid version runs in place of the free version. Only one of them can be active. If you activate the paid version first, WordPress shows the message “Please deactivate the free version of the Custom Twitter Feeds plugin before activating this version.” To continue, deactivate Smash Balloon X (Twitter) Feed on your Plugins page. Then, activate Custom Twitter Feeds Pro.

Will my feeds carry over from the free version?

Yes. Both versions use the same feeds and settings. Your feeds are there when you activate the paid version. Before you delete the free version, turn on Preserve settings if plugin is removed, as shown in Switching From the Free Version.

Where can I find my license key?

Your license key is in the email we sent you after your purchase, along with your download link.

Where can I find a feed’s shortcode later?

To find it, go to Twitter Feed » All Feeds. The Shortcode column shows the shortcode for each of your feeds. A button next to it copies the shortcode.

Can I show a different account by changing the shortcode?

No. The feed number in the shortcode decides what shows. The account is part of the feed’s settings. To show a different account, create a new feed for it, as shown in Creating Your Feed. Then, use that feed’s shortcode.

support

Couldn’t find your answer in the docs?

Contact Support