The !Followage Command: Show How Long Viewers Have Followed
One trigger that answers “how long have I been following?” with a real number pulled straight from the platform.
!followageWhat Does the !Followage Command Do?
The !followage command reports how long a viewer has been following your channel. A chatter types the trigger, and the bot replies with something like “@Dave has been following for 2 years, 4 months and 11 days.” Some setups also accept a username after the trigger, so a viewer can look up someone else — or so you can check a follow date live on stream without opening a dashboard.
Unlike a lurk or rules command, this one isn't static text. The bot has to fetch a real date from the streaming platform before it can answer, which is why followage behaves differently across bots and why it sometimes breaks when a platform changes its API. The follow relationship — who followed whom, and when — lives on Twitch's servers. Your bot asks for that timestamp, works out the difference from today, formats it into readable units and posts the result.
That extra step is the whole reason there's a small ecosystem of helper services around this command. Nightbot, for example, has no built-in followage variable, so the standard recipe routes the lookup through a public API using its URL-fetch variable. Bots with deeper platform integration can query the follow date directly. Either way, the viewer sees a single line in chat and never knows the difference — until the day the API behind it goes down and the command starts returning an error string, which is worth knowing before you build a stream ritual around it.
One nuance trips people up constantly: followage measures the time since the current follow started. If a viewer unfollows and refollows — deliberately or by accident during a channel-cleanup spree — the clock resets, and there's no way to recover the original date. When a long-time regular reports a suspiciously small number, that's almost always what happened, not a bug in your bot.
Why Streamers Use It
Follow age is a status symbol, and that's not a cynical read — it's the point. In a chat where most people are anonymous, “following since 2019” is a compact way of saying “I was here before this was a thing.” Giving viewers a command that prints that number lets them claim it themselves, publicly, without you having to hand out the credit. Communities that use it heavily tend to develop a mild competitive streak around it, and long numbers get reacted to.
For the streamer, it's a fast context tool. Someone is arguing in chat and you have no idea whether they arrived five minutes ago or five years ago; a moderator types !followage @username and you know instantly. It also gives you something concrete to react to when a viewer resurfaces after a long absence — “four years and I've never said hi properly” is a much better conversational hook than “thanks for following.”
It's genuinely useful during anniversaries and milestones too. Streamers who run channel-anniversary streams often ask chat to post their followage in the same minute, which produces a wall of numbers that visibly demonstrates the age of the community. That's a far more persuasive social proof moment than a follower count, because it shows retention rather than acquisition.
Finally, it's a low-effort answer to a question you'll otherwise be asked out loud. Viewers genuinely cannot see their own follow date anywhere obvious in the Twitch UI, so “how long have I been following you?” gets asked constantly. Answering it with a command costs you nothing and removes one more interruption from your stream — the same logic behind every other command in the chat commands library.
!Followage Variations & Example Responses
| Command | Example Response | Notes |
|---|---|---|
| !followage | @Dave has been following for 2 years, 4 months and 11 days. | The default. Looks up whoever typed the command. |
| !followage @Sam | @Sam has been following for 8 months and 2 days. | Accepts a username so mods can check someone else mid-conversation. |
| !followage (short format) | @Dave — following since 14 March 2022. | Returns the raw follow date instead of a duration. Cleaner for overlays. |
| !followage (non-follower) | @Dave isn't following yet — hit the button and start the clock! | Always customise this case. The default API response is an ugly error line. |
| !followsince | @Dave started following on 14 March 2022 at 19:41. | Common alias when you want the date rather than the elapsed time. |
| !followage (streamer self-check) | You've been following yourself since forever. Impressive. | Most lookup APIs error when the broadcaster checks their own channel. |
Set Up !Followage in StreamUps
StreamUps commands run in the cloud across your connected channels, so you can enable a Twitch-specific command like followage on Twitch while leaving it off elsewhere.
- 1Sign in to StreamUps and connect your Twitch channel (plus YouTube Live and Kick if you multistream).
- 2Open the Commands section of the dashboard and add a new command.
- 3Set the trigger to !followage.
- 4Write the response with the follow-age placeholder so the bot fills in the real value — for example: $(user) has been following for $(followage).
- 5Set a global cooldown of 10-20 seconds, since this command hits the platform API each time it runs.
- 6Enable the command on Twitch, save, and test it in your own chat with a second account to confirm the formatting looks right.
Set Up !Followage in Nightbot
Nightbot has no built-in followage variable, so the standard recipe fetches the value from a public API using $(urlfetch). DecAPI is the long-standing free option.
- 1Go to nightbot.tv, sign in and confirm Nightbot has joined your channel.
- 2Open Commands in the sidebar, choose the Custom tab and click Add Command.
- 3Set Command to !followage.
- 4Set Message to: $(touser) has been following for $(urlfetch https://decapi.me/twitch/followage/YOURCHANNEL/$(touser)) — replacing YOURCHANNEL with your Twitch username.
- 5Because $(touser) falls back to the sender when no name is given, the same command works for both !followage and !followage @someone.
- 6Set User Level to Everyone and Cooldown to 15 seconds, then Submit. Test it — if the API is down, the command will post its error text straight into chat.
Set Up !Followage in StreamElements
StreamElements ships a followage command with its bot, and you can also build your own with the customapi variable if you want different wording.
- 1Sign in at streamelements.com and open the Bot section, making sure the bot has joined your Twitch channel.
- 2Check Chat Commands → Default Commands first: a followage command is included out of the box and may only need enabling.
- 3To customise the wording, go to Custom Commands and click Add New Command instead.
- 4Set the command name to !followage.
- 5Set the response to: ${touser} has been following for ${customapi.https://decapi.me/twitch/followage/YOURCHANNEL/${touser}} — replacing YOURCHANNEL with your Twitch username.
- 6Set Cooldown to 15 seconds and access level to Everyone, then save and test with a second account.
Followage vs Sub Length — and What Each Platform Can Actually Tell You
Followage and subscription length are different numbers and they answer different questions. Following is free and instant, so follow age measures attention: how long someone has had your channel on their radar. A subscription is a recurring payment, so sub length measures commitment — and it's the one that comes with loyalty badges. A viewer can easily have followed for four years and subscribed for three months, or the reverse if they subbed during a hype moment and never followed. If your community treats one of these as the real seniority marker, be clear about which; nothing deflates a milestone faster than a bot reporting the number nobody cared about.
Sub length also resets differently. Twitch tracks cumulative months across gaps for the badge, while a follow is strictly current-streak. That's why sub-length commands and followage commands can disagree wildly for the same person, and why you shouldn't try to build one command that reports both — two triggers, two clear answers.
Platform coverage is the other thing to check before you promise chat this command. Follow age is a Twitch-native concept with a public, well-supported API, which is why almost every recipe you'll find online assumes Twitch. YouTube does not expose channel-subscription dates publicly at all, so a true YouTube “followage” is not something any bot can reliably produce — the closest equivalent is membership length, which is a paid tier. Kick has followers and a public API, but third-party tooling around follow dates is thinner and changes more often than Twitch's.
If you multistream, the honest approach is to scope the command: have it answer on Twitch and reply with a friendly “this one's Twitch-only” elsewhere, rather than posting a broken or empty result to a YouTube audience. Running commands across several platforms at once is exactly the situation where per-platform behaviour matters — see how StreamUps custom chat commands handle enabling a command per platform, and check our Nightbot alternative comparison if your current bot only reaches one of your channels.
Two operational tips. Put a global cooldown of 10-20 seconds on the command, because API-backed commands are the ones that get rate-limited when chat discovers them. And test the exact response your bot returns for a viewer who has never followed — the default from most lookup APIs is an unfriendly error line, and a one-word tweak turns it into an invitation to follow.
!Followage Command FAQ
How do I check my followage on Twitch?
Why did my followage reset to zero?
Why does my followage command return an error?
Can viewers check someone else's followage?
Is followage the same as subscription length?
Does followage work on YouTube and Kick?
Related Commands
!lurkLurk
Let viewers announce they're watching quietly without leaving the stream.
!watchtimeWatchtime
Show a viewer's total hours spent watching your streams.
!soShoutout
Give another streamer an on-stream shoutout with a link to their channel.
!discordDiscord
Drop your community Discord invite into chat on demand.
!socialsSocials
Share all of your social media links in a single chat message.
!uptimeUptime
Tell chat how long the stream has been live at any moment.
!quoteQuote
Save memorable stream quotes and replay them in chat later.
!rulesRules
Post your chat rules on demand so moderation stays transparent.
!clipClip
Let chat capture the last 30 seconds the moment something happens.
!songSong
Show whatever track is playing right now without breaking your flow.
!subcountSubcount
Put your live subscriber total in chat to fuel milestone hype.
!8ball8ball
Answer chat's questions with a random magic eight ball verdict.
!hugHug
Give viewers a way to interact with each other, not just with you.
!specsSpecs
Answer the most-asked question on any stream: what's in your PC?
Set Up Chat Commands in Minutes
Add !lurk, !so, !discord, and more to your Twitch, YouTube, or Kick chat with StreamUps. No bot hosting, no code—just pick your commands and go live.