Forms

Forms is an official Helyx module for reusable, server-scoped Discord modal forms. Managers build definitions in the dashboard, publish frozen runs, and members respond with Interested, Maybe, No, or withdrawal controls.

Forms is a live official module distributed as a public scoped npm package under the Helyx Source Available Licence. It is supported by hosted Helyx and reviewed self-hosted installations.

Behaviour and limits

• Forms and templates are scoped to one Discord server. A form supports up to five ordered text-input, selection, or text-display components and a server may retain up to ten templates.
• /forms publish and /forms repost are the only Discord commands. They default to Helyx server moderators, management replies are ephemeral, and form building and run inspection remain dashboard-only.
• Published runs freeze their question structure. Responses use one retained row per member, withdrawals remain retained, and manager decisions never send automatic messages.
• Managers may explicitly send a plain-text DM to one respondent or to the current active Confirmed, Maybe/Waitlisted, or Denied group. Every send requires immediate confirmation, disables mentions, processes at most 250 unique recipients in batches of five, and reports sent, closed-DM, and failed totals.
• DM content and per-recipient delivery outcomes are never stored or logged. Repeating a partially failed batch can deliver duplicates to earlier successful recipients.
• Closing, unpublishing, and archiving preserve results. Safe deletion is limited to unpublished or failed runs with no responses; tracked Discord posts are converged or attempted before retained data is removed.

The module uses the shared Helyx permission, audit, logging, privacy, rate-limit, scheduled-task, message, and managed-resource contracts for hosted, self-hosted, and Cloud Connect deployments.