Skip to content
Open fromusers

Install the FromUsers SDK

AdminMember In-product surveys

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

In-product survey Distribute tab showing the integration and embed guide

  1. Create a website in FromUsers.
  2. Copy the install snippet (script URL plus data-api-key and data-website-id).
  3. Decide whether you install on production, staging, or both (often two websites).
  1. Open your site’s global layout or tag manager.
  2. Paste the FromUsers snippet so it loads on pages where surveys may appear.
  3. Keep data-api-key and data-website-id exactly as provided.
  4. 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.

  1. Load a staging page with the script.
  2. Open the browser developer tools network panel and confirm fromusers-sdk.js loads.
  3. Check the console for SDK errors.
  4. Create a simple Live survey with loose targeting on staging.
  5. Confirm it appears, or call FromUsers.showSurvey as described in the JavaScript API.
  • 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.

You can deploy the snippet through a tag manager:

  1. Create a custom HTML tag with the script.
  2. Fire on All Pages or on the subset you need.
  3. Publish the container to staging and test.
  • 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.
  • 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.

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.