Migration overview: Update your embed script URL from V1 to V2. Your
window.Kno data payload can stay the same.
What is changing?
You are updating your embed script from V1 to V2.
Why should I migrate to V2?
V2 is lighter, faster to load, and has updated styling.
Do I need to change my full implementation?
No. In most cases, you only need to change v1 to v2 in the script URL.
What does the new script tag look like?
<script src="<https://www.knocdn.com/v2/embed.js?id=accountId>"></script>
Where might I find the old script?
Common places include:
Thank You page
Order Status page
Order Confirmation page
Google Tag Manager (GTM)
Other landing pages
Compatibility + breaking changes
Does the window.Kno object need updates?
No. The data object can stay the same.
What is the biggest breaking change?
Custom CSS may need updates because class names and the styling structure changed in V2.
How do I check if I’m affected by CSS changes?
Open each survey in the Survey Builder and review the Custom CSS field.
What if the Custom CSS field is blank?
You likely do not need CSS migration changes for that survey.
What if there is CSS in the field?
Review and update that CSS so the survey matches your brand in V2.
Testing + rollout
Do I need to test after switching to V2?
Yes. Validate survey appearance and behavior on a live page or a test page.
Should we clear the cache after updating to V2?
Yes. Clear cache or hard-refresh when validating the migration.
Can we run V1 and V2 at the same time?
Do not run both on the same page. Use one version per page to avoid duplicate behavior.
Is there a rollback option if issues appear?
Yes. You can switch the script URL back to V1 while you troubleshoot.
Do we need a staged rollout?
It is recommended. Test in staging or on a limited-traffic page before full rollout, especially if custom styling was added.
Google Tag Manager (GTM)
Can I migrate through Google Tag Manager?
Yes. Update the script URL in the relevant GTM tag from v1 to v2.
Support + billing
What should I do if something breaks?
Check the migration FAQ and troubleshooting docs.
Contact KnoCommerce Support with details (page URL, browser, screenshots, and any console errors).
How do I contact support?
Use in-app chat or email hello@knocommerce.com.
Are there pricing changes for moving from V1 to V2?
No.
Do I need a specific plan to use V2?
V1 and V2 are not plan-specific. The Custom Embed Integration is available on KnoCommerce Analyst or above plans for non-legacy accounts.
Do I need new credentials or a new account ID?
No, but confirm your current account ID and credentials are active before go-live.