HTML Snippet

Set Up the SDK

1. Install the SDK

   Install the Statsig SDK by adding a script tag to the head of your HTML file:

   js

   Copy

   <script
     src="https://cdn.jsdelivr.net/npm/@statsig/js-client@3/build/statsig-js-client+session-replay+web-analytics.min.js?apikey=YOUR_CLIENT_API_KEY"
     crossorigin="anonymous"
   >
   </script>
   

   Replace YOUR_CLIENT_API_KEY with your actual client API key from Project Settings > API Keys.

2. Initialize the SDK

   The HTML snippet wraps an instance of the Statsig JavaScript SDK. Providing your client API key in the URL auto-initializes the SDK, as shown in the installation step.

   Move to manual initialization if you need any of the following:

   • custom user properties
   • custom initialization options
   • check gates, configs, experiments, or log events

   To manually initialize an instance of the SDK, remove the key parameter from the script tag and do the following:

   js

   Copy

   const { StatsigClient, runStatsigAutoCapture, runStatsigSessionReplay } = window.Statsig;
       
   const client = new StatsigClient(
       '<CLIENT-SDK-KEY>', 
       { userID: 'a-user' }
   );
   
   runStatsigSessionReplay(client);
   runStatsigAutoCapture(client);
   
   await client.initializeAsync();
   
   // check gates, configs, experiments, or log events
   

   The StatsigClient instance you create is also available via window.Statsig, so you can reference it globally.

   Your StatsigClient instance provides access to all methods in the JavaScript SDK. Go to that documentation for initialization details and core methods.

Can I customize the initialization logic?

Creating an instance using the HTML snippet differs from installing through npm:

const { StatsigClient, runStatsigAutoCapture, runStatsigSessionReplay } = window.Statsig;
    
const client = new StatsigClient(
    '<CLIENT-SDK-KEY>', 
    { userID: 'a-user' }
);

runStatsigSessionReplay(client);
runStatsigAutoCapture(client);

await client.initializeAsync();

// check gates, configs, experiments, or log events