Documentation/Widget Integration SDK
v1.1.0 (Stable)

Form Wizard Widget SDK

Quickly integrate the high-performance dynamic form wizard into any third-party website, affiliate blog, or custom platform. Enjoy seamless inline container embedding with dynamic auto-resizing, custom styling presets, and automatic attribution tracking.

Interactive SDK Configurator & Sandbox

1. Core Embed Settings


2. Button Presets & Custom Styling

live_sdk_generator.js
<!-- 1. Custom container matching your initialized ID -->
<div id="shf-widget"></div>

<!-- 2. Asynchronous loader and JS API init -->
<script>
  (function(w,d,s,o,f,js,fjs){
    w['SHF']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  }(window,document,'script','shf','https://form.sellhousefast.com/widget.js'));

  shf('init', {
    type: 'container',
    containerId: 'shf-widget',
    resizeHeight: '1',
    ckey: 'aaaaaaaaaa',
    company: 'Acme Home Offers',
  });
</script>

Step-by-Step Integration Guides

1

Declarative

Best for content pages, Wordpress posts, or standard site builders. Zero programming required. Simply drop an HTML element with predefined `data` properties in the location where you want the wizard.

<div id="shf-widget" data-ckey="KEY" data-type="container" data-resize-height="1"></div>
  • Automatically loaded on script load
  • Fully styled via data parameters
2

Programmatic (Recommended)

Designed for single page applications (SPAs), web portals, or sites requiring dynamic lazy loading. Initialize on-demand, register event callbacks, and custom target container configurations.

shf('init', { type: 'container', ... })
  • Asynchronous script loading
  • Lifecycle callback event execution
3

Dev Console Injection

Perform direct inline visual audits on any active live website. Open your browser console, paste the snippet, and immediately review the functional form layout matching your target site design.

(function(){ ... window.shf('init') })()
  • Test without source deployments
  • Demonstrates seamless responsive fit

SDK Options & Configuration Reference

NameTypeRequiredDefaultDescription
typestringYescontainerType of layout to initialize. Set to 'container' for standard inline container embedding.
ckeystringYes-Affiliate or campaign key for tracking conversions and correct submission attribution.
containerIdstringYesshf-widgetThe CSS ID of the existing <div> wrapper inside your page markup where the iframe should automatically bind.
resizeHeightstring ('1' | '0')No1Enables dynamic height calculation so the container iframe resizes automatically according to wizard step content.
companystringNo-Company name displayed in the wizard header or loader screens.
btnPrimaryBgColorstring (Hex/CSS)No-Custom background color for all principal action buttons in the form flow (e.g. '#e11d48').
btnPrimaryTextColorstring (Hex/CSS)No-Custom font color for text inside primary action buttons (e.g. '#ffffff').
btnDefaultBgColorstring (Hex/CSS)No-Custom background color for all option/secondary buttons.
btnDefaultTextColorstring (Hex/CSS)No-Custom font color for standard option/secondary buttons.

Auto-Attribution & UTM Forwarding

The SDK features advanced automatic tracking passing standard ad networks click IDs and campaign UTMs directly from the affiliate host window search query parameters into the embedded wizard iframe without any coding.

Supported UTM & Click parameters:
utm_sourceutm_mediumutm_campaignutm_termutm_contentgclidgbraidwbraidfbclids1s2s3pub_id
💡 Pro Tip: Simply redirect Google Ads/Meta Ads traffic to your page. The widget automatically captures the `gclid` or `fbclid` and maps it directly to lead transactions.