Install the FromUsers SDK
Install the FromUsers SDK once per website. After that, any Live in-product survey targeted to that website can appear when rules match.

Before you install
Section titled “Before you install”- Create a website in FromUsers.
- Copy the install snippet (script URL plus
data-api-keyanddata-website-id). - Decide whether you install on production, staging, or both (often two websites).
Add the script
Section titled “Add the script”- Open your site’s global layout or tag manager.
- Paste the FromUsers snippet so it loads on pages where surveys may appear.
- Keep
data-api-keyanddata-website-idexactly as provided. - Deploy to staging first.
The script name is fromusers-sdk.js. Attributes on the script element identify your organization credentials and website.
Example shape (values come from your FromUsers website):
<script src="https://example.fromusers.cdn/fromusers-sdk.js" data-api-key="YOUR_API_KEY" data-website-id="YOUR_WEBSITE_ID" async></script>Use the real snippet FromUsers shows for your website. Do not invent hostnames.
Verify the install
Section titled “Verify the install”- Load a staging page with the script.
- Open the browser developer tools network panel and confirm
fromusers-sdk.jsloads. - Check the console for SDK errors.
- Create a simple Live survey with loose targeting on staging.
- Confirm it appears, or call
FromUsers.showSurveyas described in the JavaScript API.
Single-page apps
Section titled “Single-page apps”- Load the script once at application start.
- If your router changes pages without a full refresh, ensure targeting re-evaluates on navigation (the SDK is designed for web page contexts; test route changes explicitly).
- Fire custom events when a client-side action should open a survey.
Tag managers
Section titled “Tag managers”You can deploy the snippet through a tag manager:
- Create a custom HTML tag with the script.
- Fire on All Pages or on the subset you need.
- Publish the container to staging and test.
Security notes
Section titled “Security notes”- Treat the API key as a client-side site key for survey delivery, not as a password for your FromUsers login.
- Restrict which environments use production website IDs.
- Only Admins and trusted Members should create websites and copy keys.
Limitations
Section titled “Limitations”- No npm package and no React-specific wrapper documented as a separate install path.
- Surveys will not show if the script is blocked by an ad blocker or CSP rule. See Troubleshooting.
- The study must be Live and matching rules must pass.
Related
Section titled “Related”Common questions
Is there an npm package?
No. FromUsers delivers the in-product SDK as a script tag (fromusers-sdk.js), not as an npm package.
Where do I find the API key and website ID?
Create or open a website in FromUsers. The install snippet includes data-api-key and data-website-id for that website.
Can one snippet power many surveys?
Yes. The SDK on a website evaluates which Live surveys match targeting, triggers, and frequency for that visitor.