← All docs

Form Setup

Set up SourceTag with Heyflow

Heyflow builds interactive flows and lead funnels that can include hidden fields. SourceTag populates these with attribution data when visitors complete your flows.

What you need

  • SourceTag installed on your website
  • A Heyflow flow embedded on your site

Step 1: Open your flow in Heyflow

Log in to Heyflow and open the flow you want to track.

Step 2: Add hidden fields

  1. In the Heyflow builder, add hidden fields to your flow
  2. Set the field name for each to match the SourceTag field name exactly

Core fields (add these)

Add a hidden field for each of the following:

  • st_fc_channel
  • st_fc_detail_1
  • st_fc_detail_2
  • st_fc_detail_3
  • st_fc_detail_4
  • st_lc_channel
  • st_lc_detail_1
  • st_lc_detail_2
  • st_lc_detail_3
  • st_lc_detail_4
  • st_fc_landing_page
  • st_lc_landing_page

Optional extended fields

If you have enabled extended field groups in your SourceTag dashboard, also add:

  • st_fc_click_id and st_lc_click_id (click IDs)
  • st_visits (visit count)
  • st_days_to_convert (days since first visit)
  • st_device (device type)

See Captured Fields for the full list of available fields.

Step 3: Embed on your site

Embed your Heyflow on a page that already has the SourceTag script installed. SourceTag detects the form elements in the flow and populates the hidden fields automatically.

Make sure the flow renders as part of the page’s HTML (not inside a cross-origin iframe). Heyflow’s standard embed methods should work.

Step 4: Test

Visit the page with UTM parameters:

?utm_source=test&utm_medium=cpc&utm_campaign=heyflow-test

Complete the flow. Check the submission in Heyflow (or wherever your flow data is sent). The hidden fields should contain attribution data.

Tips

  • Hidden field names are case-sensitive. Make sure they match the SourceTag field names exactly.
  • You can copy field names from the Fields page in your SourceTag dashboard (each name has a copy button).
  • If hidden fields are not populating, inspect the rendered flow HTML in your browser dev tools. The hidden input name attribute must match the SourceTag field name.
  • Interactive flows with multiple steps work fine. SourceTag populates hidden fields as soon as it detects the form, regardless of which step the visitor is on.

Doesn't answer your question or need more help? Get in touch.