Timers & delays · Step
Take role for a time
Take a role away now and give it back after a while.
timer.temp_remove_role
In a flow
“When a button is clicked, take role for a time.”
Take @Chatter for 1h as a soft mute
What it does
Take a role away now and give it back after a while. It's a step: it runs when the white wire reaches it, then the flow carries on from its Then pin. It gives 2 values later steps can use. Find it under Timers & delays in the palette.
When to use it
Use it when timing matters: take a role away now and give it back after a while.
When not to
If nothing should change in Discord, a value node or a check is lighter.
Typical wiring
Sockets: settings you can wire
- Who Member
-
Leave unwired for the member who started the flow, or wire one in, like Member from Find member.
What goes there: Type it in the side panel, or wire in a member. e.g. @Alex
If it's empty: Optional. Left empty and unwired, the step runs without it.
Connects fromAccept applicationApplication infoAsk a questionAsk follow-upBoard as emojiCall the next in the queueCase createdCheck for a lineand 87 more
- Role Role needed
-
The role to take away for a while, like @Chatter.
What goes there: Type it in the side panel, or wire in a role. e.g. @Verified
If it's empty: Needed. Publish lists it until it's set or wired; the step can't run without it.
Connects fromAsk a questionCopy a roleCreate roleFind role by nameHighest roleMember detailsPersonal colour roleRead settingand 3 more
- For how long Text
-
How long: like 10m, 2h, 1d 12h or 3mo (a plain number is seconds). At most a year. Variables allowed.
What goes there: Type it in the side panel, or wire in text. e.g. Hello there
If it's empty: Optional. Left empty and unwired, it uses 10m.
Connects fromA member's variablesAccept applicationAdd a Notion pageAdd a Trello cardAdd an emojiAdd to number in objectAdd up timesAdd working daysand 844 more
Values it gives
- When Number
-
When it happens, as Unix time. e.g. 1792521000
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccount ageActive membersAddAdd answer to formAdd soundboard soundAdd timeAdd to a counterAdd to a leaderboardand 718 more
- When, in Discord Text
-
A Discord timestamp that shows the time in each reader's own clock. e.g. <t:1792521000:R>
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccept applicationAdd a forum tagAdd a labelAdd a Notion pageAdd a row to a Google SheetAdd a staff noteAdd a stickerAdd a Trello cardand 577 more
Shortcuts
- Take role → Wait → Give roleIt does what Take role → Wait → Give role do together, in one element.