Add-on Documentation from JCOGS Design

Payload ConfigurationLast updated: 20 January 2026

Payload Configuration pages control message layout and template customisation. These screens are primarily about what members see (subject lines, preamble/footer text, and previews), rather than delivery mechanics.

What’s the difference from Provider Settings?
  • Provider Configuration are operational details (for example sender address, TOTP parameters).
  • Payload Configuration is message composition (templates, wording, previews).
Templates and variables

Provider configuration screens that accept templates typically use OTP Pro’s email template variable system. See Email Template Variables for the authoritative list.

Default Email

The Default Email configuration controls the baseline email content used by OTP Pro’s built-in Email provider. It is the main place to customise the subject line and the surrounding copy that appears above and below the delivered payload.

What this screen controls
  • Email Subject Template – subject line template (supports {variable} placeholders).
  • Email Preamble – text shown before the payload content (supports placeholders).
  • Email Footer – text shown after the security notice (supports placeholders).
Available variables

The Control Panel shows an “Available Variables” list. This includes OTP Pro’s base variables (for example {member_name}, {payload}, {expiry_seconds}) and may also include extra variables from installed payload add-ons.

For the authoritative variable reference, see: Email Template Variables

Preview

OTP Pro provides previews using sample data. Payload add-ons may contribute additional preview blocks (for example a different layout for magic links).

Example subject template 
{site_name}: Your Verification Code
Magic links

If you use a Magic Link payload, it may have its own configuration screen under Provider Configuration. Default Email controls the baseline content; payload-specific email appearance can be configured separately when available.

Usage Notes

Email structure

Between the preamble and footer, OTP Pro inserts:

  • Payload content (code, link, etc.)
  • Security notice

Usage Notes

Plain text fields

Preamble and footer are plain text. HTML tags will be displayed as text, not rendered. Use line breaks for formatting (OTP Pro converts paragraphs/line breaks in the final email output).