Skip to main content

Introduction

This guide describes how to upgrade from v1 to v2 of our widget.

To learn more about the ways v2 improves upon v1, click here.

tip

If you are using a plugin or library that adds Friendly Captcha to your framework or CMS, usually you only have to update your plugin.

We are working on bringing v2 support to all popular languages and frameworks.

Which version am I using?​

Friendly Captcha v1​

The widget for v1 looks like this:
Screenshot of widget v1 that has not been started yet Screenshot of widget v1 that has been finished

The NPM package for v1 is friendly-challenge.
The siteverify endpoint for v1 is https://api.friendlycaptcha.com/api/v1/siteverify.

Friendly Captcha v2​

The widget for v2 looks like this:
Screenshot of widget v2 that has not been started yet Screenshot of widget v2 that has been finished

The NPM package for v2 is @friendlycaptcha/sdk.
The siteverify endpoint for v2 is https://global.frcapi.com/api/v2/siteverify.

Switching from v1 to v2​

Clientside changes (= changes to your website)​

Script tag installation​

If you installed Friendly Captcha to your website by adding a <script> tag, follow this guide.

Programmatic Javascript API​

If you are using the Javascript API to programmatically create widgets, please follow this guide

Backend changes​

You will also need to make small changes to your backend code. These are described in this guide.