Add the Recurly Engage SDK to your application by inserting the script snippet directly into your HTML. Once it's in place, Recurly Engage starts syncing customer data for personalized experiences.

Available to all customers on any Recurly Engage subscription plan

1Definition 2Key benefits 3Key details

Prerequisites

You need Administrator access to your Recurly Engage console.

Limitations

You must be able to edit and redeploy your site's HTML files.

Definition

The Direct tag integration lets you manually paste the Recurly Engage JavaScript snippet into your site's HTML, enabling Engage features without a tag manager.

Key benefits

Full control Embed the script exactly where you need it in your page lifecycle.

No external tools Skip tag managers and deploy directly in your codebase.

Performance-safe Use the defer attribute to keep the script from blocking page rendering.

Key details

Follow these steps to add the Recurly Engage SDK directly:

Log in to Recurly Engage and select your application

Make sure you're in the correct app context before retrieving your snippet.

Retrieve the JavaScript snippet

In the Engage console, go to Settings > Usage Tracking.

Copy the code snippet

Select and copy the entire <script> block provided.

Locate your root HTML file

Open your project and find the main HTML file — commonly named index.html — where your other scripts load.

Paste the snippet above the closing `</head>` tag

Insert the <script> block right before </head>. You can add defer if you'd like — it won't affect the SDK's operation.

Save and deploy your project

Commit your changes, deploy your site, and confirm the SDK loads on page view.