# Special Fields

> Formspree Docs · Building Your Form · Updated January 8, 2026

Formspree recognizes certain inputs with special names, and uses them to control the behavior of plugins and notifications. Here's a list of all the Formspree special fields, along with the behaviors they control.

## address

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">address</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">text</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">hubspot</a>, <a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The address of the new contact or lead.</td></tr></tbody></table>

## company

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">company</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">text</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">hubspot</a>, <a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The company of the new contact or lead.</td></tr></tbody></table>

## email

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">email</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">email address</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;">Email notifications, <a href="/articles/plugins/sending-a-confirmation-or-response-email/">autoresponse</a>, <a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/send-form-submissions-to-your-gladly-inbox/" target="_self">gladly</a>, <a href="/articles/plugins/use-gorgias-to-create-support-tickets/" target="_self">gorgias</a>, <a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">hubspot</a>, <a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a>, <a href="/articles/plugins/use-mailerlite-to-create-subscribers/" target="_self">mailerlite</a>, <a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The email address of the person submitting the form. For submission notifications, this will be used in the Reply-To header. For newsletter or CRM plugins, it will set the primary email address of the contact. See also the <a href="/articles/building-your-form/email-reply-to-address/" target="_self">help article on setting the Reply To address</a>.</td></tr></tbody></table>

## message

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 89.75px; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 587.25px; height: 22px;">message, msg</td></tr><tr style="height: 22px;"><td style="width: 89.75px; vertical-align: top; height: 22px;"><strong>Type</strong></td><td style="width: 587.25px; height: 22px;">text</td></tr><tr style="height: 22px;"><td style="width: 89.75px; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 587.25px; height: 22px;"><a href="/articles/plugins/send-form-submissions-to-your-gladly-inbox/" target="_self">gladly</a><a href="/articles/plugins/use-trello-to-create-cards/" target="_self">, </a><a href="/articles/plugins/use-gorgias-to-create-support-tickets/" target="_self">gorgias</a><a href="/articles/plugins/use-trello-to-create-cards/" target="_self">, </a><a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">hubspot</a>,<a href="/articles/plugins/use-trello-to-create-cards/" target="_self">&nbsp;trello</a>, <a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 89.75px; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 587.25px; height: 22px;">The message or main text area of the form. For support center plugins like Zendesk, it will set the body of the ticket, however all other fields will also be included in the ticket below the message body.&nbsp;</td></tr></tbody></table>

## name

<table style="border-collapse: collapse; height: 110px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">name, firstName, lastName</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; vertical-align: top; height: 22px;"><strong>Type</strong></td><td style="width: 85.8572%; height: 22px;">text</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-gorgias-to-create-support-tickets/" target="_self">gorgias</a><a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">, hubspot</a>, <a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a>, <a href="/articles/plugins/use-mailerlite-to-create-subscribers/" target="_self">mailerlite</a>,&nbsp;<a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a>&nbsp;</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The name of the person submitting the form. Certain plugins like Mailchimp have separate first name and last name fields. For these plugins, if the <code>name</code> field contains two words, it will be split into first and last names. For more control, you can use the <code>firstName</code> and <code>lastName</code> special fields instead to explicitly set the first and last names, respectively.&nbsp; &nbsp;</td></tr></tbody></table>

## _optin

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 89.7422px; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 587.258px; height: 22px;">_optin</td></tr><tr style="height: 22px;"><td style="width: 89.7422px; vertical-align: top; height: 22px;"><strong>Type</strong></td><td style="width: 587.258px; height: 22px;">checkbox / boolean</td></tr><tr style="height: 22px;"><td style="width: 89.7422px; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 587.258px; height: 22px;"><a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a>, <a href="/articles/plugins/use-mailerlite-to-create-subscribers/" target="_self">mailerlite</a></td></tr><tr style="height: 22px;"><td style="width: 89.7422px; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 587.258px; height: 22px;">If a newsletter plugin is configured to use the _optin field, new contacts will only be added to the newsletter when this field is set in the submission.&nbsp;</td></tr></tbody></table>

## phone

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">phone</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">phone number</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-hubspot-to-create-leads-and-contacts/" target="_self">hubspot</a>, <a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a>, <a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The phone number of the new contact or lead.</td></tr></tbody></table>

## _price

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">_price</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">number</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-stripe-to-accept-payments-with-sca/" target="_self">stripe</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">If the stripe plugin is configured to accept a variable price, the _price field will determine the amount of the charge. See the <a href="/articles/plugins/use-stripe-to-accept-payments-with-sca/" target="_self">help article on Stripe</a>.</td></tr></tbody></table>

## priority

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">priority</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">one of "low", "medium", "high" or "urgent"</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">For help desk plugins, sets the priority of the new ticket.&nbsp;</td></tr></tbody></table>

## subject

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">subject</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">text</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;">Email notifications, <a href="/articles/plugins/send-discord-notifications/" target="_self">discord</a>, <a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-gorgias-to-create-support-tickets/" target="_self">gorgias</a>, <a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a>, <a href="/articles/plugins/send-slack-notifications/" target="_self">slack</a>, telegram, <a href="/articles/plugins/use-trello-to-create-cards/" target="_self">trello</a>,&nbsp;<a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a>&nbsp;</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The subject or topic of the message. For submission notifications, this will be used in the Subject header. Note: this should probably be a hidden or select input, not free text. See the <a href="/articles/building-your-form/email-subject-line/" target="_self">help article on setting the Subject</a>.</td></tr></tbody></table>

## tags

<table style="border-collapse: collapse; height: 110px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 95.4844px; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 581.516px; height: 22px;">tags</td></tr><tr style="height: 22px;"><td style="width: 95.4844px; vertical-align: top; height: 22px;"><strong>Type</strong></td><td style="width: 581.516px; height: 22px;">a comma separated list of tag names</td></tr><tr style="height: 22px;"><td style="width: 95.4844px; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 581.516px; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-gorgias-to-create-support-tickets/" target="_self">gorgias</a>, <a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a>, <a href="/articles/plugins/use-mailchimp-to-collect-email-addresses/" target="_self">mailchimp</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 95.4844px; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 581.516px; height: 22px;">For help desk plugins, adds a list of tags to the ticket. Typically this should be a hidden field, or controlled by a select input.</td></tr></tbody></table>

## urgent

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">urgent</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">checkbox / boolean</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-freshdesk-to-create-support-tickets/" target="_self" rel="undefined">freshdesk</a>, <a href="/articles/plugins/use-zendesk-to-create-support-tickets/" target="_self">zendesk</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">For help desk plugins, sets the priority of the new ticket to "urgent".&nbsp;</td></tr></tbody></table>

## value

<table style="border-collapse: collapse; height: 88px; margin-top: 1em;"><tbody><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Field Name</strong></td><td style="width: 85.8572%; height: 22px;">value</td></tr><tr><td style="width: 14.1428%; vertical-align: top;"><strong>Type</strong></td><td style="width: 85.8572%;">number</td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Used By</strong></td><td style="width: 85.8572%; height: 22px;"><a href="/articles/plugins/use-pipedrive-to-create-leads-and-contacts/" target="_self">pipedrive</a></td></tr><tr style="height: 22px;"><td style="width: 14.1428%; height: 22px; vertical-align: top;"><strong>Description</strong></td><td style="width: 85.8572%; height: 22px;">The value of the new contact or lead. Currency will be determined by the attached plugin.</td></tr></tbody></table>
