Skip to main content

Quick Start

Get Recapt up and running on your website in under 5 minutes.

Prerequisites

Before you begin, make sure you have:

  • A Recapt account (sign up at recapt.app)
  • Access to edit your website's HTML

Step 1: Get Your API Key

  1. Log in to your Recapt dashboard
  2. Navigate to Installation from the sidebar
  3. Click Generate to create your API key
  4. Copy the generated key - you'll need it in the next step

Step 2: Add Your Domain

  1. In the Installation wizard, proceed to the Domain Settings step
  2. Enter your website's domain (e.g., example.com)
  3. Click Add Domain
  4. Add any additional domains or subdomains where you'll use Recapt
tip

Include all domains and subdomains where you plan to install Recapt. For example, if you have example.com and app.example.com, add both.

Step 3: Install the Script

Add the following script tag to your website's <head> section:

<script
src="https://cdn.recapt.app/browser/glimt.js"
async
data-public-key="YOUR_API_KEY"
data-persist
></script>

Replace YOUR_API_KEY with the API key you generated in Step 1.

To associate sessions with your users, add this code after a user logs in:

window.recapt("identify", {
uid: "USER_ID", // Required: Your user's unique identifier
email: "user@email.com", // Optional: User's email
nickname: "Username", // Optional: User's display name
});

Verify Installation

After installing the script:

  1. Visit your website in a browser
  2. Interact with the page (click around, scroll, navigate)
  3. Go to your Recapt dashboard
  4. Navigate to Sessions - you should see your session appear within a few minutes

What's Next?