# Forms

> Capture leads from website form submissions and automatically add them to your contact lists.

Source: https://docs.graph8.com/signals/forms/

graph8 tracks form submissions on your website and converts them into contacts. Every time someone fills out a form — a demo request, contact form, newsletter signup, or booking form — graph8 captures the submission and can automatically add the lead to a list for outreach.

## How Form Tracking Works

graph8's tracking script monitors form submissions on your website. When a visitor submits a form, the tracker captures:

- **Form fields** — all field names and values (passwords and sensitive fields are excluded)
- **Page context** — the URL, page title, and referrer where the form was submitted
- **Visitor data** — IP address, country, and session information
- **Timestamp** — when the submission occurred

This works with any HTML form on your website — no custom integration needed. The tracker also supports AJAX forms and popular form builders like WPForms.

## Viewing Form Submissions

Go to **Signals → Forms** to see all tracked forms. Each form shows:

- **Form ID** — the HTML form identifier
- **Page URL** — where the form lives on your site
- **Total submissions** — how many times it's been filled out
- **Last submitted** — when the most recent submission came in

Click into a form to see individual submissions with all captured field data.

### Filtering Submissions

Filter submissions by:

- Date range
- Country
- Page URL or path
- IP address

## Mapping Forms to Contacts

The key feature is mapping form fields to contact fields so submissions automatically create or update contacts in graph8.

### Setting Up a Mapping

1. Go to **Signals → Forms** and select a form
2. Click **Map Fields**
3. For each form field, select the corresponding contact field:

| Form Field | Maps To |
|-----------|---------|
| email | Email |
| first_name | First Name |
| last_name | Last Name |
| company | Company |
| phone | Phone |
| job_title | Job Title |

4. **Preview** the mapping to see how submissions would look as contacts
5. **Select a target list** — choose which list new contacts should be added to
6. Click **Save**

### Automatic List Population

Once a mapping is saved, graph8 automatically processes new submissions:

1. A visitor submits the form on your website
2. graph8 captures the submission data
3. The field mapping is applied to extract contact information
4. The contact is created (or updated if they already exist) in your target list

This runs in real time — new form submissions appear as contacts within seconds.

> **Tip:**
> Map your highest-traffic forms first — demo request forms and contact forms are usually the best starting point. These capture the strongest buying signals.

## Appointment Forms

graph8 also tracks booking and appointment forms. When a prospect books a meeting through your website, the submission is captured the same way as regular forms and contributes to their signal score.

## Form Signals

Every form submission generates a signal on the contact's profile:

- Form submissions are weighted at **25 points** — the highest-value signal type
- Recent submissions (last 3 days) get an additional **+20 point** recency bonus
- A single demo form submission can push a contact's signal score above 40

This means contacts who fill out your forms automatically rise to the top of your priority list.

## Next Steps

- [Signals Overview →](https://docs.graph8.com/signals/overview/) — How signal scoring works
- [Website Visitors →](https://docs.graph8.com/signals/website-visitors/) — Track and identify anonymous visitors
- [Intent Tracking →](https://docs.graph8.com/signals/intent-tracking/) — Set up keyword and topic tracking
