Flow reference: Plugins

Post Suggestion

Turn text into a suggestion card with upvote / downvote counts, staff Accept / Consider / Deny with a reason, and a discussion thread (Suggestions plugin).

Turn text into a suggestion card with upvote / downvote counts, staff Accept / Consider / Deny with a reason, and a discussion thread (Suggestions plugin).

When and how to use it

Connect the input from the preceding step on the path that should perform this operation.
Fill the fields with data available in the trigger's context.
Connect the needed outputs; an unconnected path cannot run later blocks.

Configuration fields

Channel — channel


Choose the channel this block targets or filters. Use its Discord ID or a supported channel variable. Check channel overrides for the bot.

Input: Text.

Format example, not a ready value for your server: {channel}.

Default: {channel}.


Suggestion text — text


Text input for this check, transformation or suggestion. If it comes from a member, avoid treating it as trusted code or configuration.

Input: Text with variable suggestions.

Default: {message.content}.


Suggested by — author


Identify the member credited as the author. Keep the actual caller available separately when checking permissions.

Input: Text with variable suggestions.

Default: {user}.


Delete the original message — deleteOriginal


Remove the source message after posting the suggestion when enabled. Check that the new suggestion was actually created.

Input: On/off switch.

Default: true.


Open a discussion thread — thread


Whether to create a discussion thread for the suggestion. The bot needs the relevant thread permissions.

Input: On/off switch.

Default: true.


Staff role (can review) — staffRole


Role allowed to use staff review actions. Choose a trusted role rather than everyone.

Input: Text with variable suggestions.

Default: {env.SUGGESTIONS_STAFF_ROLE}.

Outputs and next steps

out: Continue to the next step.
failed: The operation failed; provide a safe error response.

Test and troubleshoot

Install the corresponding plugin and configure its required accounts, channels and secrets. Test an API read before a write operation. An external-service error is not a reason to recreate the whole bot.

Save, validate and publish. Perform one real test and read the first relevant log error. [Testing](/docs/flow-testing) · [Variables](/docs/flow-variables) · [Permissions](/docs/flow-permissions).