Docs chevron_right Features

Actions

How the actions system works, what it can do, and more.

The actions system allows you to automate form workflows using a scratch-style drag and drop editor.

It consists of two types of blocks:

  1. Activators. These are how you trigger a set of "Action" blocks to activate.
  2. Action Blocks. These represent the action which will be run by the bot.

Types of Activators

On Submit

The On Submit activator runs the set actions as soon as the submission has been saved.

On Button

The On Button activator lets those with the permission trigger_actions activate the workflow. This type of activator has additional features which the On Submit one does not.

  1. You can use the {custom_text} variable to add custom text when you activate the button in a modal.

You can customise the button with different colours, and emojis.

Available Colours:

  1. Blue
  2. Gray
  3. Green
  4. Red
infoInfo

This is sadly a limitation due to how discord renders buttons in embeds and Components v2 payloads. We would add more colours if we could!

Types of Actions

Grant/Remove Roles

This action type lets you give and take roles from the user which submitted the form.

DM Message

This lets you send a DM to the user which submitted the form along with a set of useful variables.

  1. {username} shows the user's Display Name.
  2. {mention} pings the user.
  3. {user_id} shows the user's Unique ID.
  4. {form_name} shows the name of the form.
  5. {date} shows the current date.
  6. {custom_text} lets you send custom text upon activating the workflow (with a modal popup). This only works in On Button activator.

Delete Submission

This lets you automatically delete the submission from Forminator's databases.