# Set up SourceTag with Nutshell CRM

Canonical: https://sourcetag.io/docs/setup-nutshell

When a visitor submits a form with SourceTag data, the attribution fields need somewhere to go in Nutshell. You need to create custom contact fields that match the SourceTag field names.

## What you need

- SourceTag installed and form hidden fields set up
- Nutshell CRM account with admin access

## Step 1: Go to custom fields

In Nutshell, go to **Setup > Custom Fields > People**.

## Step 2: Create custom fields

Create a new text field for each SourceTag data point:

### Core fields (create these)

| Field name | Label | Type |
|-----------|-------|------|
| `st_fc_channel` | First Click Channel | Text |
| `st_fc_detail_1` | First Click Smart Field 1 | Text |
| `st_fc_detail_2` | First Click Smart Field 2 | Text |
| `st_fc_detail_3` | First Click Smart Field 3 | Text |
| `st_fc_detail_4` | First Click Smart Field 4 | Text |
| `st_lc_channel` | Last Click Channel | Text |
| `st_lc_detail_1` | Last Click Smart Field 1 | Text |
| `st_lc_detail_2` | Last Click Smart Field 2 | Text |
| `st_lc_detail_3` | Last Click Smart Field 3 | Text |
| `st_lc_detail_4` | Last Click Smart Field 4 | Text |
| `st_fc_landing_page` | First Click Landing Page | Text |
| `st_lc_landing_page` | Last Click Landing Page | Text |

### Optional extended fields

| Field name | Label | Type |
|-----------|-------|------|
| `st_fc_click_id` | ST First Click ID | Text |
| `st_lc_click_id` | ST Last Click ID | Text |
| `st_visits` | ST Visits | Number |
| `st_days_to_convert` | ST Days to Convert | Number |
| `st_device` | ST Device | Text |

See [Captured Fields](https://sourcetag.io/docs/captured-fields) for the full list of available fields.

## Step 3: Map the fields

Connect your form submissions to Nutshell. How you do this depends on your setup:

**Nutshell Web Forms:** If using Nutshell's built-in web forms, map the hidden fields from your form to the custom fields you created.

**Zapier/Make:** If your forms connect to Nutshell via Zapier or Make, map each SourceTag hidden field to the corresponding Nutshell custom field in your Zap/scenario.

**Direct integration:** If your form builder has a direct Nutshell integration, map the fields in the integration settings.

## Step 4: Test

Submit a form with UTM parameters:

```text
?utm_source=test&utm_medium=cpc&utm_campaign=test-campaign
```

Check the new contact in Nutshell. The custom fields should show the attribution data.

## Tips

- Nutshell custom field names are case-sensitive. Make sure the mapping matches exactly.
- You can use Nutshell's reporting to filter contacts by channel or campaign for ROI analysis.
- Attribution data appears as custom fields on the person record, so you can view and filter by it directly.
