Timers & delays · Step
Pin for a time
Pin a message now and unpin it after a while.
timer.pin_for
In a flow
“When a button is clicked, pin for a time.”
Pin today's event for 1 day
What it does
Pin a message now and unpin it 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: pin a message now and unpin it 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
- Message Message
-
The message, as a link or ID. Leave empty for the message this flow is about (the one clicked or posted).
What goes there: Type it in the side panel, or wire in a message. e.g. a link to the message
If it's empty: Optional. Left empty and unwired, the step runs without it.
Connects fromCountdown messageCreate pollCreate poll from a listExport form recordsFind messageForward messagePinned messagesPoll with resultsand 526 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 1d.
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
- Pin message → Wait → Unpin messageIt does what Pin message → Wait → Unpin message do together, in one element.