Sign inGet Started Free
FeaturesPricingBlogResourcesAboutContact
Sign inGet Started Free

An X (Twitter) feed widget that treats a post made of words as the point

Connect the account, choose which posts publish, and paste one snippet into any site builder. The post arrives whole and stays in your page, so a reader reads it where they already are instead of being sent somewhere else. Photographs are welcome. They are just not the requirement.

Start your free trialSee pricing

7-day trial with X switched on, no credit card.

From the club account
Lampblack Runners3 hours ago

The club 1500 record went tonight. 4:11.6, second attempt, into a headwind nobody wants to talk about. The board gets a new line in the morning.

4026348
Lampblack Runners11 hours ago

Wet asphalt, flat grey river, six miles at talking pace. The best runs of the year are always in the worst weather of it.

A runner on a wet waterfront promenade, empty benches along the railing and a suspension bridge and city skyline flattened by haze behind.
143917

Lampblack Runners is a demo account we invented, at an invented address, and the photographs are CC0 stand-ins. The column, the crop and the counts are the widget's.

1
Premium source in the product, and this is it
12h
Between refreshes, on every paid plan
40
Layouts in the studio
16
Themes, free on every plan
Try it here

Most of what an account posts is a sentence, and a sentence is worth a column

A cancelled session, a result, a change of meeting point. Start on List, which gives each post its own row rather than a tile in a grid, then switch layouts and themes and turn captions, dates, avatars and badges on and off. No signup, no connection, and the posts below are the ones a running club would actually write.

Layout
Theme
Display
Showing List Minimal
The 1500m start marking painted on a red running track, shot from ground level with the stadium out of focus behind.
Lampblack Runners3 hours ago

The club 1500 record went tonight. 4:11.6, second attempt, into a headwind nobody wants to talk about. The board gets a new line in the morning.

A runner on a wet waterfront promenade, empty benches along the railing and a suspension bridge and city skyline flattened by haze behind.
Lampblack Runners11 hours ago

Wet asphalt, flat grey river, six miles at talking pace. The best runs of the year are always in the worst weather of it.

A building and bare branches reflected upside down in a puddle on wet asphalt.
Lampblack Runners1 day ago

Tuesday intervals are off. The track is a sheet of ice and we are not going to pretend otherwise. Easy five on the road instead, same time, same place.

Bare and rust-coloured trees in a public park with fog sitting between them and leaf litter across the grass.
Lampblack Runners2 days ago

Fog on the park loop at six, four degrees, nobody dropped off the back. Thursday is the same route in reverse.

List. One post per row, text beside its image. The closest thing to reading the account itself, and where a feed that is mostly words should start.

Build this with your own feed

A preview, not the live renderer. The theme colours are read from the product's own theme definitions and the layout names are the real ones, but the shapes here are drawn for this page, because the widget renderer is a Deno edge function that a Next app cannot import. Every preview post carries a photograph so those drawn shapes have something to hold, while a real X feed is mostly text and the widget renders those posts whole. The studio itself carries 40 layouts and 16 themes, a theme builder on every plan, and renders the actual widget as you edit. Lampblack Runners is a club we invented, at an invented address, and the photographs are CC0 stand-ins.

The whole post

What a card carries, field by field

These are the exact fields the widget is handed at serve time, and nothing else reaches the card. That fixed set is also why the box underneath can say plainly what a card will never show you.

The post text, carried whole

The card holds the entire post rather than a preview that sends the reader somewhere else. It shows about five lines by default with a Read more control for the rest, and a layout can set that depth or switch the limit off.

Display name and avatar

The account name and picture as X returns them. If a post arrives without a picture, the card draws the first initial instead rather than leaving a hole.

One image, when there is one

The first photo attached to the post. Text posts simply carry no image, which is the ordinary case rather than a failure state.

Age, floored

Rendered as "3 hours ago" and floored, never rounded, so the dashboard and the embedded widget can never show the same post at two different ages.

Likes, replies and reposts

Three counts, hidden individually when the platform has no such number. Reposts and quote posts arrive as separate figures and are added together into the single reposts count you see.

A link back to the post

Every post keeps its own address on x.com. A card opens a panel with the whole post and a View on Twitter button by default, and you can set cards to open the original directly instead, or not to be clickable at all.

What is not on the card, and why

There is no handle under the name. The widget is handed a fixed set of fields at serve time and the account handle is not one of them, so drawing one on this page would be a picture of a feature that does not exist. The name, the age and the link back to the post are what identify it.

There is no follower count and no verification tick either. We show what the post carries, not a portrait of the account.

And when there is one

A photograph gets the full width, not a thumbnail

The first image attached to a post renders above the text at the width of the column. Because photographs are the exception in a text feed rather than the rule, they land as an event instead of as wallpaper.

Lane numbers painted across a red synthetic track, shot low along the lane lines in flat light.
Lampblack Runners5 days ago

Lane one is repainted and the club handicap is back on the 24th. Entries close when the whiteboard runs out of room.

128159

Lampblack Runners is a demo account we invented, at an invented address, and the photographs are CC0 stand-ins. The column, the crop and the counts are the widget's.

What a plan buys

You buy X sources, and each one refreshes every 12 hours

X bills per post returned. That is the whole reason it is the one paid source here, and the reason every serious vendor in this category caps X sources rather than selling them by the dozen. So those are the two numbers worth knowing, and both of them are on this page.

Your first pull, on Pro
Posts asked for50
Posts X returned34
Waiting in your queue34
Then, every 12 hoursNew posts only

Illustrative figures in the real sequence: you size the first pull, X answers with what the account actually has, and every sync after it asks only for what is newer.

Every 12 hours, on every paid plan

X refreshes every 12 hours on every paid plan because X bills per post returned. It is one number rather than three, it is deliberately slower than every other network we support, and it is the same on Pro as it is on Scale. During the free trial an X source refreshes once a day. Your other platforms keep your plan's own update frequency.

Nothing new to fetch, nothing fetched

Every sync asks X only for posts newer than the newest one already stored, so a quiet week returns an empty answer and changes nothing. That marker survives deleting the source and adding it again, so a re-add cannot pull down posts you already have.

The official API, not a scraper

Every post arrives through X's own documented v2 API on a token you approved. That is why the source count is capped rather than unlimited, and it is also why the feed does not depend on x.com page markup staying where a scraper last found it.

Pro: 1 X source 路 updates every 12 hours

Each source can be a profile timeline or a public hashtag search. The first pull defaults to 50 posts and you can move it before you commit. Everything after that is new posts only.

Business: 2 X sources 路 updates every 12 hours

Each source can be a profile timeline or a public hashtag search. The first pull defaults to 100 posts and you can move it before you commit. Everything after that is new posts only.

Scale: 5 X sources 路 updates every 12 hours

Each source can be a profile timeline or a public hashtag search. The first pull defaults to 100 posts and you can move it before you commit. Everything after that is new posts only.

Refreshing

It updates on its own, every 12 hours

Two mechanisms, and the honest version of both. An X source is not on the same clock as the rest of your feed, and the button that skips the clock is a paid one.

On a timer

X feeds refresh every 12 hours

They do update automatically, but not at your plan's general refresh rate. X refreshes every 12 hours on every paid plan because X bills per post returned, and once a day during the free trial. A new post can therefore take up to a cycle to appear.

Every paid plan 12h 路 free trial once a day

On demand

Or press Pull now and skip the wait

Paid plans get a manual pull between scheduled syncs, up to 100 posts a press and once an hour, so something posted this morning does not have to wait for the next cycle to reach the page.

100 posts per press 路 1 press per hour 路 paid plans

Why an X source is slower than the others

Your plan sets a general refresh rate for every source you connect, from once a day on the free plan down to every few minutes at the top. An X source ignores it and takes the slower of the two, because X bills per post returned and a faster clock on a metered API pays to check rather than to publish. Live event walls lift every other platform to a two minute refresh and deliberately leave X where it is, for the same reason.

Design

Layouts that do not need a photograph to hold together

A grid built for pictures turns a text feed into a wall of grey rectangles. These three are shaped for words. All 40 layouts and all 16 themes work with an X feed, and the free plan includes 7 of the layouts plus every theme and the theme builder.

Lampblack Runners1 day ago

Tuesday intervals are off. The track is a sheet of ice and we are not going to pretend otherwise. Easy five on the road instead, same time, same place.

Lampblack Runners4 days ago

New here? Turn up at half six on a Tuesday or a Thursday. No membership form, no fee, and nobody is ever left running on their own.

Lampblack Runners3 hours ago

The club 1500 record went tonight. 4:11.6, second attempt, into a headwind nobody wants to talk about. The board gets a new line in the morning.

List Free plan

One post per row, full text, nothing cropped. The closest thing to reading the account itself, and the layout most pages should start with.

Lampblack Runners3 hours ago

The club 1500 record went tonight. 4:11.6, second attempt, into a headwind nobody wants to talk about. The board gets a new line in the morning.

Quote wall

One post at a time, set large, the rest waiting behind it. For a sentence that deserves the width of the page rather than a third of it.

Lampblack Runners6 days ago

Head torches from here until March. If you own one reflective thing, wear it on the arm that swings.

A person from behind under a black umbrella on a rainy street at night, traffic and shop lights thrown into long coloured reflections on the wet road.
Lampblack Runners4 days ago

New here? Turn up at half six on a Tuesday or a Thursday. No membership form, no fee, and nobody is ever left running on their own.

Social news

A lead post with an image over a run of headlines, so a mixed week of words and pictures still reads as one column.

What you can point it at

An account, a hashtag, and nothing we had to take

Pro carries 1 X source, Business 2 and Scale 5, each one can be either kind, and every one of them refreshes every 12 hours.

Your account

The profile timeline

Connect the account and the widget reads its own posts. Original posts only: retweets and replies are excluded at the request, so the feed on your page is what the account said rather than what it passed along.

A hashtag

A public hashtag search

Point a source at a tag instead of an account and it reads the public recent-search endpoint, with no connection needed. Retweets and replies are filtered out there too. Available on every paid plan, and inside the trial.

Not scraped

The official API, or nothing

Every post comes from X鈥檚 own v2 API with a token you approved. We do not read x.com pages to get around a limit, so the feed on your site does not depend on x.com markup staying where a scraper left it.

Setup

Four steps, each shown with what it produces

The second step is the one no other platform has: you decide how far back the first pull reaches into the account's history. Everything after that is new posts only.

Step 1

Connect the account

Pick X / Twitter in the source list and approve read access on X's own screen. A hashtag source needs no connection at all, because it reads the public search endpoint.

Add a source
X / TwitterTweets and hashtagsConnect

Choosing this hands you to X's own sign-in page to approve read access. We never draw that screen, and we never ask for your password.

Step 2

Say how much history you want

The first pull is the only one that reaches into the back catalogue, so you size it yourself instead of accepting a fixed number. Everything after it is new posts only.

First pull

You choose how far back the first pull reaches. The default and the ceiling both come from your plan, and the create page shows both before you commit.

Step 3

Choose what publishes

Posts land in a queue where you approve, pin or drop each one, and keyword rules can filter them before you look. Curation is on every plan, free included.

Collect

The club 1500 record went tonight. 4:11.6, second attempt, into a headwind nobody wants to talk about. The board gets a new line in the morning.

Tuesday intervals are off. The track is a sheet of ice and we are not going to pretend otherwise. Easy five on the road instead, same time, same place.

Approve, pin to the front, or drop. Keyword rules can do it for you before you ever see the post.

Step 4

Paste one snippet

The embed dialog asks where the widget is going and hands out the right snippet for that host. The step-by-step for each builder lives in the setup guide.

Embed
<!-- CollectSocials -->
<div id="cs-feed"></div>
<script src=".../widget.js"
  data-feed-id="..."
  data-container="cs-feed"
  defer></script>

Abridged, with the real attribute names and the real ids filled in for you. Builders that block scripts are handed a self-resizing frame instead.

The step-by-step for each host, including where the snippet goes in WordPress, Shopify, Wix, Squarespace and Webflow, is in the platform instructions in our setup guide. This page is the argument; that article is the walkthrough.

Compatibility

One widget, every website platform

A script tag is not universally installable: some builders sandbox custom code, others strip it. So the embed dialog asks where you are installing and hands out the right snippet for that host.

Script embed

Plain HTML, WordPress, Webflow, React

One script tag and one container div. The widget renders inside a Shadow DOM, so its CSS and yours cannot interfere.

Wrapped script

Shopify

The same script with a page-width wrapper, because Shopify themes lay sections out with flexbox and would otherwise compress the container.

Iframe embed

Wix and Squarespace

Both sandbox or strip custom scripts, so these get an iframe that resizes itself as content loads. No clipped posts, no inner scrollbar.

Bare URL

Notion and Google Sites

Builders that cannot run scripts at all take a fixed-height frame by URL. Content scrolls inside it.

One wall

An X post reads better with company

One feed can combine 10 platforms, so a post can sit beside an Instagram photo, a Facebook update and a Google review in the same section. Every other platform in that wall is on the free plan.

Priya R.2 weeks agoGoogle

Booked the sunrise trip on the strength of the photos and it was better than the pictures. The guides knew exactly where to be and when.

A walker standing on a dark volcanic ridge as the sun breaks under storm cloud over the seaYouTube

Three days on the ridge trail, start to finish

Riders on a painted swing carousel flung out over a clear blue sky, seen from belowTikTok

The swings go right out over the water

Atlas & Pine@atlasandpine 路 3dTwitter/X

Sunrise crew made the ridge before the storm broke. Whole set is up on the site now.

Atlas & Pine5wFacebook

Lagoon day. Six boats out, nobody tipped in, and the water stayed that colour the whole afternoon.

Kayakers in red and yellow boats threading a turquoise lagoon between limestone cliffs
Marcus T.1 month agoGoogle

Second trip with them this year. Everything ran on time and the small group size is the whole point.

Someone dancing in front of a bright yellow wall, hair thrown across their faceInstagram

Found the yellow wall. Obviously we danced at it.

A couple silhouetted on a dune crest against a wide sunburst, ripples in the sand belowInstagram

Made the crest just before the sun did.

Hot-air balloons drifting over pale rock formations at dawnInstagram

Up before the balloons were.

Atlas & Pine7wFacebook

End of the festival, and they let the whole lot go at once. Nobody said a word for about ten seconds.

Hundreds of coloured balloons rising together into a clear blue sky

A demo feed for an invented brand, showing 6 of the 10 live sources in one wall. The posts, reviewers and engagement numbers are illustrative, not product metrics. Every field on these cards is one the widget really renders, but the wall itself is drawn for this page rather than served by the widget.

Pricing

The one source you pay for, and why

X is the only platform that bills us for reading it, so it is the only one behind a paid plan. What you are buying is how many X sources you can run and how often each one refreshes.

Free, with a 7-day trial
  • X / Twitter: 1-week free trial
  • Up to 3 X sources in the trial, refreshed once a day, no card
  • 7 of the 40 layouts, all 16 themes
  • Full curation: approve, pin, drop

After the trial, X becomes a paid source and every other platform stays free. Free widgets carry a small CollectSocials credit link.

Paid, from $29/month
  • Pro: 1 source 路 12-hour updates
  • Business: 2 sources 路 12-hour updates
  • Scale: 5 sources 路 12-hour updates
  • Pull now on demand, 100 posts a press

All 40 layouts, hashtag sources, and the credit link removed. Paying yearly is two months free, so Pro is $290 a year, Business $590 and Scale $1,190. Full pricing breakdown.

FAQ

X feed widget questions, answered straight

Is the X feed widget free?

No, and it is the only source in the product that is not. X bills per post returned, so an X feed costs us money every time it refreshes and a plan has to carry that cost. Every other platform we support is on the free plan. New accounts get X switched on for the 7-day trial with no card, on up to 3 sources that refresh once a day, and paid plans start at $29 a month, or $290 a year with two months free.

How many X posts can a widget show?

Every X post you approve stays in the feed and keeps serving, because posts are stored on our side rather than fetched on each page view. The only ceiling is your plan鈥檚 overall posts-stored limit, which is shared across every platform rather than being an X number. What a plan sets for X specifically is how many sources you can connect and how often each one refreshes: 1 source on Pro, 2 on Business and 5 on Scale, and every one of them refreshes every 12 hours.

How often does the feed update?

Automatically, on a schedule of its own. Most platforms sync at your plan鈥檚 general refresh rate, but X sources carry their own floor: X refreshes every 12 hours on every paid plan because X bills per post returned. During the 7-day trial an X source refreshes once a day. Paid plans can also press Pull now for an immediate refresh, once an hour.

Do I need my own X developer account or API key?

No. The API access is ours, and you approve read access to your account on X鈥檚 own sign-in screen. We ask for three permissions and no more: read posts, read your profile, and stay signed in so the feed can keep refreshing without you reconnecting every couple of hours. We cannot post, follow, message or delete anything.

Does it show retweets and replies?

No. A profile source asks X for original posts only, so retweets and replies never arrive in the first place. A hashtag source filters them out the same way. If you want a reply thread on your site, the honest way is to pin the post it belongs to and let a reader open the conversation on X.

Can I show a hashtag feed instead of my own account?

Yes, on any paid plan and inside the trial. A hashtag source needs no account connection, because it reads the public recent-search endpoint with our own application credentials. One quirk worth knowing: that endpoint will not accept a request for fewer than ten posts, so a hashtag source is always asked for at least ten at a time rather than one or two. The setup guide walks through it.

What happens if X changes its API?

X versions and documents its API, and every post in your feed arrived through it with a token you approved, so a feed here does not depend on x.com page markup the way a scraped one does. Posts already collected are stored on our side and keep serving even while a source is disconnected, so reconnecting an account is never a blank section on your page.

Can I choose which posts appear?

Yes, and on every plan. Posts land in a queue where you approve, pin to the front or drop each one, and keyword rules can filter them before you ever look. That matters more on X than anywhere else, because a timeline that reads well in a feed can read very oddly as a permanent section of your homepage. All 16 themes and the theme builder are on the free plan too.

Which website builders does it work with?

WordPress, Shopify, Wix, Squarespace, Webflow, Notion, Google Sites, plain HTML and React. The embed dialog asks where the widget is going and hands out the right snippet for that host, because some builders sandbox custom scripts and others strip them. WordPress can skip the code entirely with our plugin.

Is it still Twitter or is it X?

Both names are in use and the product answers to either. The source is called X / Twitter in the dashboard, posts link back to x.com, the mark on each card is the X one, and the button that opens the original still reads View on Twitter. What actually changed for embedding is more than a logo, and the setup guide covers it.

Can X posts sit beside my other platforms?

Yes. One feed can combine 10 platforms, so an X post can sit next to an Instagram photo, a Facebook post and a Google review in the same section, styled as one wall rather than four widgets stacked up. For most sites that is the point: the photograph shows the thing and the post says what happened.

Put the account on the site tonight

Connect X, choose the posts that publish, pick a layout, paste one snippet. The 7-day trial has X switched on and asks for no card.

Start your free trial

Works with WordPress, Shopify, Wix, Squarespace, Webflow, Notion, Google Sites, React and plain HTML.