> ## Documentation Index > Fetch the complete documentation index at: https://formsplugin.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Mailchimp > Connect Mailchimp with Framer Forms using the Forms Plugin to automatically add form submissions to your Mailchimp audience. # Connect Mailchimp with Framer Forms Capture leads from your Framer forms and automatically add them to your Mailchimp audience using the Forms Plugin. *** ## Step 1 - Get Your Mailchimp API Key Before connecting Mailchimp to your form, generate an API key from your Mailchimp account. This API key allows the Forms Plugin to securely send form submissions to your Mailchimp audience. Mailchimp account showing the API Keys settings page 1. Login to your Mailchimp account 2. Navigate to **Profile** → **Extras** → **API Keys** 3. Click **Create A Key** 4. Copy the generated API key Keep your API key in a secure password manager. Never share it publicly or commit it to a code repository. *** ## Step 2 - Insert Mailchimp Component Into Your Form Select your form in the Framer canvas and insert the Mailchimp component. The component connects your form to Mailchimp and automatically detects the form fields in your form layout. Forms Plugin panel in Framer showing the Mailchimp Integrations screen with the Insert Mailchimp Component button *** ## Step 3 - Configure Mailchimp API Settings After inserting the Mailchimp component, configure the API settings in the component properties panel. Framer canvas with Mailchimp component selected showing the API Settings modal 1. Select the **Mailchimp Integration** component in your form 2. Open the properties panel on the right side 3. Paste your **Mailchimp API Key** 4. Enter your **Audience ID** (List ID) ### Required Fields * **API Key** - Paste the API key generated from your Mailchimp account. * **Audience ID** - Enter the Mailchimp Audience ID (also called List ID) where new subscribers should be added. *** ## Step 4 - Configure Field Mapping Map your form fields to Mailchimp subscriber attributes. The component automatically detects your form field names. You simply connect each field to the correct Mailchimp attribute. Framer canvas showing the Mappings modal with form fields mapped to Mailchimp attributes ### Example Mapping | Form Field | Mailchimp Attribute | | ---------- | ------------------- | | email | EMAIL | | firstname | FNAME | | lastname | LNAME | *** ## Step 5 - Configure Tags (Optional) Tags help you segment subscribers in Mailchimp. The Forms Plugin supports two ways to apply tags from a single form: **Static Tags** that are applied to every submission, and **Dynamic Tags** that are derived from a form field's selected value.
Forms Plugin Field Mappings panel showing Mappings, Static Tags filled with pastries, and Dynamic Tags with 1 item
### Static Tags Use Static Tags when you want the **same tag(s) applied to every submission** from this form - for example, tagging every signup as `pastries`, `newsletter`, or `framer`. 1. Open the **Field Mappings** panel for the Mailchimp component 2. In the **Static Tags** field, enter one or more tag names separated by commas (e.g., `pastries, newsletter`) Static Tags are great for identifying the **source** of a subscriber (e.g., `landing-page`, `pricing-page`, `webinar`) so you can build segments and automations in Mailchimp later. ### Dynamic Tags Use Dynamic Tags when you want the tag to come from **what the user selected** on the form - for example, a "Favorite Snacks" dropdown where the chosen option becomes the tag in Mailchimp. 1. Open the **Field Mappings** panel for the Mailchimp component 2. Click **Dynamic Tags** to add an item 3. Enter the **Field Name** - this must match the form field's `Name` property exactly (the same value used by Conditional Logic) 4. Choose a **Format** based on the field type (see below) 5. Repeat to add multiple fields if needed
Dynamic Tag Fields Item modal in the Forms Plugin showing Field Name input and Comma vs Array format toggle
#### Format: Comma vs Array The **Format** option tells the plugin how to read values from the form field: * **Comma** - Use for fields that submit a **single hidden input with values joined by commas**. Choose this for `ButtonChoice`, `Select`, `Checkbox`, and `ImageButtonChoice` fields. * **Array** - Use for fields that submit **multiple inputs sharing the same name**. Choose this for native HTML checkbox groups. If you pick the wrong format, tag values may be missed or merged incorrectly. **Field option values must be in kebab-case** The **value** of each option becomes the tag name in Mailchimp - not the visible label. Set option values in lowercase kebab-case (e.g., `value="coffee-beans"`, not `Coffee Beans`). Otherwise, your Mailchimp tags will appear with spaces or unexpected casing. #### Example Here is a real Framer form with a Dropdown component named `tag` and three options. The **Field Name** (`tag`) is what you enter in the Dynamic Tag modal, and the **option values** (`pastries`, `tea`, `coffee-beans`) are what become tags in Mailchimp. Framer canvas showing a Dropdown component with Field Name set to tag and Options panel listing label/value pairs Pastries/pastries, Tea/tea, Coffee Beans/coffee-beans | Option Label | Option Value | Tag Created in Mailchimp | | ------------ | -------------- | ------------------------ | | Pastries | `pastries` | `pastries` | | Tea | `tea` | `tea` | | Coffee Beans | `coffee-beans` | `coffee-beans` | Combined with Static Tags `pastries`, a submission selecting "Coffee Beans" will be tagged with `pastries` and `coffee-beans` in Mailchimp. ### Where to Manage Tags in Mailchimp Tags applied from the Forms Plugin are **created automatically in Mailchimp** the first time they are used - you do not need to pre-create them. To view, rename, or delete tags later: 1. Open your Mailchimp account 2. Go to **Audience → Tags** ([direct link](https://us13.admin.mailchimp.com/audience/tags/)) 3. From this page you can search existing tags, click **Create new tag** to add one manually, or use **Bulk tag** to apply a tag to multiple contacts at once Mailchimp Audience Tags page listing tags pastries, tea, and coffee-beans created from form submissions The URL path `/audience/tags/` may vary by Mailchimp data center prefix (e.g., `us1`, `us13`, `eu1`). If the link above doesn't open, navigate via **Audience → Tags** in the sidebar. *** ## Step 6 - Result When a user submits the form, their details will automatically be added to your Mailchimp audience along with any configured tags. You can verify new subscribers in your [Mailchimp Audience dashboard](https://us13.admin.mailchimp.com/audience/contacts/). Completed Mailchimp integration on a form with Integration active status In the **Audience → Contacts** view, the **Tags** column shows the tags applied to each contact, and the **Source** column shows `API - FormsPluginIntegration` for submissions that came in through the plugin. Mailchimp Audience Contacts page showing tags such as coffee-beans, tea, and pastries applied to subscribers from the Forms Plugin ## Next Steps * [Integrations Overview](/integrations/overview) * [Contact Support](https://go.formsplugin.com/contact) if you need help