Home → Content & Apps →


    The Twitter Live Module

    With the Twitter Live module, you can display a feed of live tweets the instant they are tweeted, from a range of sources including keywords, phrases, tags, user accounts, @ mentions, location and retweets, just like Twitter's advanced search options.

    Adding Twitter Live Modules to Content & Apps Views

    All modules are added to a View in the same way with our drag-and-drop interface. To get more information on this, see the Building a View: Adding Modules and Content to Views in Content & Apps help article.

    Once you have added a module and given it a name, the module will open for you to edit it or add content. Back on the View layout, you'll see a callout bubble next to your module - click the triangle for controls for your module. This callout will not appear on your published View and your new module will not appear on Facebook until you click Publish.

    Note: This module works in any position on your View.

    Creating a Twitter App

    To set up a Twitter Live module, you need to create an app in the developers section of Twitter.

    1. Go to https://dev.twitter.com/apps. Sign in with your normal Twitter credentials.
    2. Hover on your user pic and name in the upper right corner, and click on My applications.
    3. Click Create a new application.
    4. Give your application a name, short description, and website URL. Scroll down the page and check the box to agree to the terms of service, enter the captcha words, then click Create your Twitter application.
    5. You'll be taken to the info page for your new application. On the Details tab, scroll down to the Auth Settings section. You'll need the following items:
      • API Key
      • API Secret
      • Access Token
      • Access Token Secret

    When you open the Edit section for the module, you will see fields for these items and you can enter them there.

    Important: You should only use one Twitter application for each Twitter Live module you create on your Views. You can create multiple apps on your Twitter account, but only use one per module.

    Adding Twitter Accounts and Settings to a Twitter Live Modules

    When you drag-and-drop a Twitter Live module onto a View, it will automatically open to the edit page for that module. To set up a module you've already created:

    1. Next to your Twitter Live module you’ll see a callout bubble. Click the green triangle next to the title to show your options.
    2. Click the Edit Module button. You will be taken to the Edit Twitter Live Module section.

    There are many options for you to set, and you can use combinations of these options so your module displays exactly the tweets you want.

    • Number of Tweets Displayed: Use the drop-down menu to select the number of tweets you want displayed on the module. You can select between 1-15.
    • Tweets Include: All of These Words - Enter words that, if they all appear in a tweet, will make that tweet appear on your module's feed.
    • Tweets Include: This Exact Phrase - Enter a phrase that, if this phrase appears in a tweet, will make that tweet appear on your module's feed.
    • Tweets Include: Any of These Words - Enter words that, if any of them appear in a tweet, will make that tweet appear on your module's feed.
    • Tweets Include: None of These Words - Enter words that, if any of them appear in a tweet, will prevent that tweet from appearing on your module's feed.
    • Tweets Include: These Hashtags - Enter hashtags and tweets with those hashtags will appear on your module's feed.
    • Tweets: Written In: - Select a language from the drop-down menu, and any tweets in that language will appear on your module's feed.
    • Tweets: From These Accounts - Enter Twitter usernames and tweets made by those users will appear on your module's feed.
    • Tweets: To These Accounts - Enter Twitter usernames and tweets made to those users will appear on your module's feed.
    • Tweets: Mentioning These Accounts - Enter Twitter usernames and tweets that mention those users will appear on your module's feed.
    • Tweets: Near This Place - Enter a city name or zip code and tweets that have been sent from that city or zip will appear on your module's feed.
    • Tweets: Within This Distance - Use this in combo with Tweets: Near This Place, select a distance from the drop-down menu, and any tweets made within that distance from the city or zip you entered above will appear on your module's feed. You can select from miles and kilometers.

    Note: When you enter info into the fields for To, From, and Mentions, the module will pull in tweets that only meet all those criteria. So if you want tweets from specific users AND to specific users, you might want to add a second Twitter Live module for those options.

    You can also select to include tweets that contain special characters - check the boxes of the ones you want to include:

    • Positive :) - Displays tweets with a positive sentiment.
    • Negative :( - Displays tweets with a negative sentiment.
    • Question ? - Displays tweets that ask a question.
    • Include retweets - Displays retweets as well as original tweets.

    You can select how often you want your module to refresh its content. Use the drop-down menu to specify a rate between 5-60 seconds.

    Saving Settings

    Once you have finished configuring your module, click the Update button to save your changes.

    Related Topics