Documentation

Get up and running

One script tag. Under 5 minutes. Your first survey can be live before your next meeting.

Quick start

Selge is a one-script install. Here's how to go from signup to live survey in four steps.

  1. 1. Sign up and create a project

    A project maps to one website domain. Go to selge.app, sign up for free, and your first project is created automatically during onboarding.

  2. 2. Create a survey

    In your dashboard, go to Surveys → New survey. Start from a blank survey or pick one of the 14 expert templates. Build your questions, choose a widget style, and save.

  3. 3. Copy your embed code

    Go to Settings → Embed. Copy the script tag with your project ID. Paste it into your site's <head> or just before </body>.

  4. 4. Publish and go live

    Back in the builder, click Publish. The survey goes live immediately. Responses appear in your dashboard in real time.

How it works

Selge uses a three-stage loading pattern designed to have zero impact on your site's performance.

Stage 1 — Loader script (~0.6KB gzip)

The tiny script you paste into your site. It reads your project ID and checks if any surveys are configured for this visitor, then exits immediately if nothing should show.

Stage 2 — Config fetch (cached 60s)

A lightweight API call that returns which surveys are active, their targeting rules, and any triggers. Responses are cached so repeat page loads are near-instant.

Stage 3 — Widget bundle (~16KB gzip)

Only loaded if a survey should show for this visitor. Renders inside a closed Shadow DOM — your styles can't break it, it can't break yours. No cookies, no tracking.

Install — Any website

Paste this script tag into your site's <head> or just before the closing </body> tag. Replace YOUR_PROJECT_ID with the ID from Settings → Embed.

<script
  src="https://cdn.selge.app/loader.js"
  data-selge-project="YOUR_PROJECT_ID"
  async
></script>

The script is loaded asynchronously — it won't block your page from rendering. Your actual project ID is shown in Settings → Embed.

WordPress

The easiest way is to use a plugin that lets you add code to your site's <head>. We recommend Insert Headers and Footers (free, widely used).

  1. Install and activate Insert Headers and Footers
  2. Go to Settings → Insert Headers and Footers
  3. Paste the script tag into the "Scripts in Header" box
  4. Save

Alternatively, add the script tag to your theme's header.php just before the closing </head> tag.

Webflow

  1. Open your Webflow project
  2. Go to Project Settings → Custom Code
  3. Paste the script tag into the "Head Code" field
  4. Save and publish

The survey will appear on published pages, not in the Webflow editor preview.

Shopify

  1. In your Shopify admin, go to Online Store → Themes
  2. Click Actions → Edit code on your active theme
  3. Open layout/theme.liquid
  4. Paste the script tag just before the closing </head> tag
  5. Save

Squarespace

  1. Go to Settings → Advanced → Code Injection
  2. Paste the script tag into the "Header" field
  3. Save

Code injection is available on Business plans and above.

Google Tag Manager

Use a Custom HTML tag to inject the Selge script.

  1. In GTM, go to Tags → New
  2. Choose tag type: Custom HTML
  3. Paste the script tag into the HTML field
  4. Set trigger to: All Pages
  5. Name the tag "Selge" and save
  6. Submit and publish your container

Building surveys

The survey builder has a split-pane layout: questions and settings on the left, live widget preview on the right.

Question types: Multiple choice, checkbox list, NPS (0–10 with optional follow-up), open text, star rating (1–5), emoji scale, and yes/no.

Widget style: Choose from modal, popup, slide-in, or bottom bar. Pick a position and a brand color — Selge generates the full palette automatically.

Auto-save: Drafts save every 500ms. Publishing is a separate explicit action — drafts never go live by accident.

AI creation: Use the "Describe it" tab in the new survey modal to generate a ready-to-edit survey from a plain text description. Claude creates the questions; you review and adjust before publishing.

Templates: 14 expert templates with WHY/WHEN/HOW/WHAT guidance. Starting from a template takes 30 seconds to configure and launch.

Targeting & triggers

Control exactly who sees your survey, when, and how often — per survey.

Page rules

Show the survey on specific pages only. Match by exact URL, URL contains, or regex. A survey targeting /pricing will only appear on your pricing page.

Triggers

Four trigger types: Immediate (shows on page load), Time delay (shows after N seconds), Scroll depth (shows when visitor reaches N% of the page), Exit intent (shows when cursor moves toward the browser chrome — Pro plan only).

Dismiss cooldown

How long to wait before showing the survey again to a visitor who dismissed it. Default is 30 days. Uses sessionStorage — no cookies required.

Response cap

Set a maximum number of responses. The survey pauses automatically when the cap is reached.

Reading results

The results page updates in real time (auto-refreshes every 30 seconds).

Overview stats

Total responses, completion rate, and average time to complete at the top.

Per-question charts

Each question shows an inline chart matching its type: bar chart for choice questions, NPS gauge for NPS, star distribution for ratings.

Response table

All responses in a table with sortable columns. Click any row to open a detail slide-over. Flag individual responses with a star for follow-up.

Filters

Filter by date range, page URL, or answer value. Filters apply to both charts and the response table.

CSV export

Export all filtered responses as a CSV. One column per question, formatted for Excel (BOM included). Available on all paid plans.

AI summaries

Selge uses Claude Haiku to generate a holistic insight summary for each survey — patterns, key quotes, and suggested next actions.

Summaries appear above the per-question charts on the results page. They auto-generate once per day when new responses arrive. You can also trigger a manual refresh at any time.

A minimum of 5 responses is required before a summary is generated.

Plan limits: Starter plans get 5 AI summaries per month. Pro plans are unlimited.

Billing & plans

Free account: Build and preview unlimited surveys. No credit card required. Publishing a survey to your live site requires a paid plan.

Starter ($19/mo): 1 project, 500 responses/month. All core features including AI summaries (5/mo) and CSV export.

Pro ($49/mo): 5 projects, 5,000 responses/month. Exit intent trigger, badge removal, unlimited AI summaries, API access, and MCP server.

Annual billing: 20% discount on both plans ($15/mo Starter, $39/mo Pro).

Response limits: Surveys auto-pause when the monthly limit is reached. Responses reset on your billing date.

Cancellation: Cancel at any time. Surveys pause, your data is retained for 90 days, and resubscribing restores everything.

API & MCP

Selge has a REST API and an MCP server for integration with AI coding environments.

API keys

Generate API keys in Settings → API & Integrations. Keys are shown once on creation — copy and store them securely. Keys can be revoked at any time.

REST API

Authenticate with a Bearer token. Rate limit: 60 requests/minute per key.

Authorization: Bearer sk_your_api_key

MCP server

Install @selge/mcp to use Selge inside Claude Code, Cursor, or any MCP-compatible AI assistant. Three tools: create_survey, list_surveys, get_results.

{
  "mcpServers": {
    "selge": {
      "command": "npx",
      "args": ["-y", "@selge/mcp"],
      "env": {
        "SELGE_API_KEY": "sk_your_api_key"
      }
    }
  }
}

See the MCP integration page for full documentation and use cases.

Something not covered here?

The docs are a work in progress. If you're stuck, open an issue on GitHub and we'll sort it out.

Free to sign up and build No credit card required Set up in under 5 minutes

Free to build - pay only when you go live