Circle supports Single Sign-On (SSO), and you can now integrate Circle with Wordpress, making it a seamless experience for your Wordpress members to log in to your community! These members won't have to sign up or log in with their Circle account — instead, they'll use Wordpress credentials and access Circle from your log in page.

🚨 If you plan to use a custom domain, set that up first as this will change your Callback URL. Not doing this first can potentially lead to being locked out of your account.

✅  Step 1: Set up Circle integration in Wordpress

If you don't have an OAuth plugin yet, you can install WP OAuth or another that fits your needs. In your Wordpress sidebar navigate to OAuth Server → Clients → Add New Clients. Please ensure that 'Authorization Code' is checked on the left-hand side.

Name your integration, and then locate your Circle Redirect URI by navigating back to Circle Community Settings → Single Sign-On. You will want to locate your Callback URL for this field.

🚨 We recommend keeping the "Allow members with a Circle account to sign in" toggle enabled to avoid getting locked out of your account while setting up your SSO integration. In the case this happens, you can easily sign in again with your Circle credentials.
Once you paste the URL in Wordpress, click "Create Client" and you will be presented with your custom ID's.

✅  Step 2: Copy over Wordpress SSO information to Circle

Navigate to back to Circle Settings → Single Sign-On, and select "Wordpress" as the OAuth provider.

Type in your provider name, then paste in your Client ID along with the Client Secret provided by Wordpress and click "Save".

✅  Step 3: Enable SSO with Wordpress

Once you've saved your settings, toggle "Enable SSO" to ON within Circle.

  • Allow members with a Circle account to sign in: If you have members that have already registered their email with Circle, they can still sign in with those credentials using a separate sign in button.

💡 What happens to Circle member accounts?
If this is toggled ON, Circle members can continue to login using the "Sign in with Circle" button. We will create accounts for Wordpress members automatically on our backend if the email doesn't exist within Circle.

If this is toggled OFF, members with Circle accounts will no longer be able to sign in with those credentials unless the email of their Circle account matches the email of their Wordpress account, in which case we'll link the two automatically going forward.

💡 What happens to my admin account?
If the email you use to log in to Wordpress is different from Circle, we recommend toggling this ON to ensure you don't get locked out of your admin account. Once you grant admin rights to both accounts you can always toggle this off later.

If this is toggled OFF, you will only be able to log in under your email that is registered within Wordpress.
  • Allow members to sign up via a custom URL: After enabling SSO, members won't be able to sign up via Circle. However, you can keep the sign up button visible and point it to a custom URL.

🏁  If the setup was successful, you will now see the Login via Wordpress Single Sign-On option when trying to sign in under your community!

Common Errors:

  • Temporarily Unavailable Error: Solution

Suggested Articles: