What External Tracking Does
External Tracking connects external website activity to Kyrios by using a lightweight tracking script. After the script is installed, Kyrios can:
Track page views on external pages
Detect supported forms automatically
Capture form submissions in real time
Create or update contacts from submissions
Store unmapped form fields safely
Capture page URL, source, UTM, and session data
Trigger workflows from page views or form submissions
Key Benefits
External Tracking reduces manual form setup because Kyrios can detect supported external forms automatically.
Key benefits include:
Automatic form detection
Real-time submission capture
Automatic contact creation or updates
Smart field matching
UTM and attribution tracking
Multiple form tracking on the same page
No Zapier, webhook, or manual mapping required
Supported Forms
External Tracking supports forms rendered directly in the page DOM.
Supported examples include:
Gravity Forms
WPForms
Contact Form 7
Custom HTML forms
No-code website builder forms that use standard form elements
External Tracking does not support iframe-based forms or third-party widgets that do not expose real form inputs on the page.
Form Requirements
External Tracking works best when the form meets these requirements:
The form uses a valid
<form>HTML elementForm fields include
nameattributesThe form includes an email field when contact creation is needed
Fields are visible in the DOM
The form is not embedded inside an iframe
Forms that do not expose inputs to the page cannot be reliably captured.
Smart Field Mapping
Kyrios automatically maps submitted form fields to contact fields and custom fields when it can identify a match. Kyrios uses field names, labels, and existing field structure to match data. If Kyrios cannot map a field, the field is stored under unmapped fields so the submission data is not lost.
How to Get the Tracking Script
Go to Settings.
Select External Tracking.
Open the Installation tab.
Click Copy Script.
The tracking script is unique to the account. Do not edit or remove the tracking ID.
Confirm the Script Was Copied
After clicking Copy Script, Kyrios shows a copied confirmation. Use this confirmation to verify that the script is ready to paste into the external website.
How to Install the Script on an External Website
Paste the script before the closing </body> tag on every page where tracking or form capture is needed. Example format:
<script
src="https://link.yourdomain.com/js/external-tracking.js"
data-tracking-id="tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
</script>
The script must load on the same page as the form for Kyrios to detect and capture the submission.
WordPress Example: Open the Forms Area
In WordPress, open the form plugin area where the external form is managed.
For example, go to the WordPress dashboard and select the forms plugin menu.
WordPress Example: Select the Form to Edit
Open the form that should load the Kyrios tracking script.
This step is only needed when you want to place the tracking script directly inside a specific WordPress form or page.
WordPress Example: Add the Script to an HTML Block
Inside the form builder, add an HTML block and paste the Kyrios tracking script into the block content.
Global installation before the closing </body> tag is still recommended when possible.
Test the External Form
After installation, submit the external form as a visitor would. Kyrios should detect the form and capture the supported submitted fields.
The visitor experience does not change. The form submits normally while Kyrios captures the data in the background.
View External Form Submissions in Kyrios
To view captured submissions:
Go to Sites.
Select Forms.
Open Submissions.
Filter by External Forms if needed.
Captured submissions appear with the submitted field data and contact information.
View Contact Activity Details
Each captured submission is also attached to the contact activity record.
Activity details can show:
Submitted fields
Page URL
Source
Timezone
External Form status
Unmapped fields
Event data
Use unmapped fields when a submitted field was captured but did not match an existing Kyrios field.
Workflow Triggers
External Tracking can trigger workflows from external website activity.
Available trigger types include:
Page View
Form Submission
Available filters can include:
Domain
Page path
External form name
UTM parameters
Use workflow triggers when external website behavior should start follow-up, lead routing, tagging, notifications, or pipeline actions.
Common Issues and Fixes
The form submission is not appearing in Kyrios
Confirm the tracking script is installed on the same page as the form. Also confirm the form is not inside an iframe and uses a valid <form> element.
Fields are showing as unmapped
Kyrios stores unmapped fields when it captures the data but cannot match the field to an existing contact field or custom field. Review the unmapped fields in the activity details and create matching fields if needed.
The page view is tracked but the form is not captured
The form may not be rendered directly in the DOM. Iframe forms, popup widgets, and third-party scripts that hide form inputs are not supported.
FAQ
Do I need to configure form mapping after installing the script?
No. Kyrios automatically detects supported forms and maps fields when possible.
Does External Tracking work with Gravity Forms and WPForms?
Yes. External Tracking supports most DOM-based Gravity Forms and WPForms when the tracking script loads on the page.
Can multiple forms on the same page be tracked?
Yes. Kyrios can track multiple supported forms on the same page independently.
Are iframe-based forms supported?
No. External Tracking does not support iframe-based forms.
Where can I view external form submissions?
External form submissions are available under Sites → Forms → Submissions and inside the related contact activity details.
What happens to unmapped fields?
Unmapped fields are stored safely in the submission activity details so the data is not lost.