WooCommerce Social Login: Create Social Apps

This document walks through the creation of apps for each social network that you can connect to WooCommerce Social Login. For all other information specific to the plugin, including settings, usage, and FAQs, please view the full user documentation.

The plugin currently supports login with these platforms:

Once you’ve set them up, you can enter credentials and adjust the settings for each under WooCommerce > Settings > Social Login by selecting the correct service. This guide will only walk through creating apps for each network.

If you use WP Engine for hosting or a caching plugin, you may receive authentication errors. Please follow the steps here to be sure that you do not encounter these issues.

Connecting Facebook ↑ Back to top

If your Facebook app was created after March 2018, you must enable Force SSL for all providers under WooCommerce > Settings > Social Login.

To connect your WooCommerce store to Facebook, log into your Facebook account. Go to developers.facebook.com while logged in and click “My Apps > Add a New App” to create an app.

If you’ve never logged into developers.facebook.com before, you may see a “Get started” action in the top right instead. Use this to register and verify your account first.

Enter your app name + an email address for your store:

WooCommerce Social Login Facebook app, step 1

Choose “Facebook Login” for the app type, and click “Set Up”:

WooCommerce Social Login: facebook set up 1

Do not use the “Quickstart” you’ll be taken into; instead, click “Settings > Basic” for the app:

WooCommerce Social Login: Facebook set up 2

Click “Add platform”, and then select “Website” as your platform.

WooCommerce Social Login: Facebook set up step

Now enter the rest of the basic details for your store. You can

  1. set the display name (the name of your store; will be shown to customers when they approve app access to log in),
  2. set a namespace (an optional identifier – helpful for subdomains but not needed),
  3. set “category” to whatever you’d like,
  4. and optionally add site URLs and a logo.

WooCommerce Social Login: Facebook set up step

Click on “Facebook login > Settings” next. Add the following URLs to the “Valid OAuth Redirect URIs” field on this page (note: your endpoints may be different):

  • homepage URL (https://mystore.com)
  • checkout URL (https://mystore.com/checkout)
  • order received URL (https://mystore.com/order-received)
  • account page URL (https://mystore.com/my-account)
  • API request endpoint (https://mystore.com/?wc-api=auth&done=facebook)
  • any page you intend to use as a return URL, which is helpful for shortcodes and / or widgets

WooCommerce Social Login: Facebook set up step

Last step! Go to “App Review” and change the app status to live / public (or do so from your top bar):

WooCommerce Social Login: Facebook set up step

The setup is done! Now you can go back to “Settings” or “Dashboard” and grab your App ID and Secret. Enter them under WooCommerce > Settings > Social Login > Facebook.

WooCommerce Social Login Facebook app credentials
Copy Credentials

Connecting Twitter ↑ Back to top

To connect your WooCommerce store to Twitter, you must create a Twitter app. Log into Twitter, then go to apps.twitter.com. Click “Create App”:

WooCommerce Social Login Create Twitter App
Create Twitter App

Enter the name of your store and a description for your app. Use your site URL for the website URL.

The callback URL for Twitter is a bit of a weird one. There is an example listed under WooCommerce > Settings > Social Login > Twitter. It will probably look something like this:

https://MYSTORE.com/?wc-api=auth&done=twitter

BUT MAY BE DIFFERENT. Please refer to the plugin settings for this.

However, we’ve found that Twitter can cut this URL off before &done, so we recommend first just re-entering your store URL for the callback. We’ve found this works in 99.5% of cases with just the home URL as the callback, but if you use the regular callback and it gets cut off, that’s okay too, as https://MYSTORE.com/?wc-api=auth also works in our tests.

WooCommerce Social Login: new Twitter application

This is most likely a bug in the Twitter platform which we’ve raised with their team, and this document will be updated if they provide feedback.

Agree to the developer agreement, and click “Create your Twitter Application”. Once you’ve confirmed your settings and created your app, you’ll be able to manage the app.

From the main app page, navigate to your “Settings” page and ensure the option to “Allow this application to be used with sign in with Twitter” is enabled, then save.

WooCommerce Social Login Confirm Twitter Sign In
Confirm Twitter Sign In

You can also change the app icon to your store logo if desired, or adjust other app settings that customers will see.

Now our setup is done. All we have to do is grab the API Key and API Secret from the “Keys and Access Tokens” page:

WooCommerce social login twitter API credentials
Get API Credentials

Now you can copy these credentials and save them under WooCommerce > Settings > Social Login > Twitter.

Connecting Google ↑ Back to top

To connect your WooCommerce store to Google, log into your Google account. While logged in, navigate to https://console.cloud.google.com/cloud-resource-manager. Click “Create Project”:

WooCommerce Social Login: Create Google Project

Enter your project’s name (this is shown to customers to approve the login) and click “Create”:

WooCommerce Social Login: Name Google Project

Wait a moment for Google to create your project, it may take a bit of time for the page to refresh.

Once you’ve created a project, click on “Credentials” on the left-hand side, then select “OAuth Consent Screen” at the top. You’ll need to enter your site / company information here.

WooCommerce Social Login: add Google consent screen

Now go to the “Credentials” tab and click “Create credentials”. You’ll select “OAuth client ID” for the type.

WooCommerce Social Login: Create Google Credentials

Select “Web application” for your application type, and complete the application fields.

Under “Authorized Javascript Origins”, enter your site URL.

The “Authorized Redirect URI” is listed under WooCommerce > Settings > Social Login > Google. It will probably look something like this:

https://MYSTORE.com/?wc-api=auth&done=google

BUT MAY BE DIFFERENT. Please refer to the plugin settings for this.

WooCommerce Social Login Google App URLs

Click “Create” to save this setup and generate your credentials. You can copy these credentials and save them under WooCommerce > Settings > Social Login > Google.

WooCommerce social login google credentials

Connecting Amazon ↑ Back to top

Please be sure to read these directions carefully. Amazon does not make this setup easy unfortunately. You must Force SSL under WooCommerce > Settings > Checkout.

To connect your WooCommerce store to Login with Amazon, you’ll need to log into your own Amazon account. If you don’t already have a developer account set up, you’ll need to register for a Developer account using your existing Amazon account or a new one.

If you’re creating a new Amazon account, go through the registration process and select that you won’t be monetizing your app. When Amazon asks you for tax information, you can click “Ask Me Later”, as you won’t be listing this as an Amazon app and only using Login functionality.

Once you’re logged into or registered for your developer account, follow these steps to create a security profile for your app.

  1. Go to Login With Amazon (click this link, or go to “Apps & Services”, then “Login with Amazon”). Click “Create a New Security Profile”:

    WooCommerce Social Login Security Profile Amazon

  2. Enter your store’s information and privacy policy URL:

    WooCommerce social login amazon security profile

Once your profile has been created, go to Settings > Web Settings in the bottom right (the cog icon):

WooCommerce Social Login Edit Amazon Profile

From here, click “Edit” to set the Allowed Return URL. The Allowed Return URL is listed under WooCommerce > Settings > Social Login > Amazon. It will probably look something like this:

https://MYSTORE.com/?wc-api=auth&done=amazon

BUT MAY BE DIFFERENT. Please refer to the plugin settings for this. Note that the URL MUST be https://.

WooCommerce Social Login Amazon return URL
Edit Return URL

Click “Save”, and go to the “General Tab”. This page will have your Client ID and Secret credentials so you can enter them at WooCommerce > Settings > Social Login > Amazon.

WooCommerce Social Login Amazon Credentials

Connecting LinkedIn ↑ Back to top

To connect your WooCommerce store to LinkedIn, visit the LinkedIn Developer Portal and log in with your LinkedIn credentials. You’ll be taken to the developer center where you can click “Create Application”.
WooCommerce Social Login LinkedIn Apps

Fill out the application form with your store’s information. For Application Use, select “Other”.

WooCommerce Social Login LinkedIn complete app form
Complete App Form

You’ll now see your application’s page and settings. Set your app to “Live” status under the app’s “Settings” page and click “Update”.

WooCommerce Social Login LinkedIn App settings

Now go to the “Authentication” page you were first at. Under Default Application Permissions, choose r_emailaddress and r_basicprofile.

You’ll next set the OAuth 2.0 Authorized Redirect URLs. The OAuth 2.0 Redirect URL is listed under WooCommerce > Settings > Social Login > LinkedIn. It will probably look something like this:

http://MYSTORE.com/?wc-api=auth&done=linkedin

BUT MAY BE DIFFERENT. Please refer to the plugin settings for this. This is the only URL that has to be filled in – you can leave the other OAuth and Javascript URLs blank, as they’re all optional settings.

WooCommerce Social Login LinkedIn app settings
App Authentication settings

Save these changes, and copy the API credentials at the top of the “Authentication” page to connect your store. Copy the Client ID and Client Secret.

You can now enter them at WooCommerce > Settings > Social Login > LinkedIn and save your settings.

Connecting PayPal ↑ Back to top

Please note that you can’t have a “live” PayPal app using a personal PayPal account. To obtain live PayPal credentials, you must have a verified Premier or verified Business PayPal account (these accounts are free to signup).

If you do not have a business account, you won’t be able to access live credentials:

WooCommerce Social Login PayPal

To connect your WooCommerce store to PayPal, visit the PayPal Developer Center and log in using your PayPal account credentials. If you don’t already have a developer account, this will generate one for you.

Under REST API apps, click the “Create App” button.

WooCommerce Social Login: Create PayPal App

You can then enter a name for your app and click “Create App” again.

WooCommerce Social Login: New PayPal App

This will take you to the settings page for your new PayPal App. The first thing you should do is click “Live” in the top right to generate a live social login connection (if you want to only test this with Sandbox accounts, you can duplicate this with sandbox credentials as well).

Now scroll down to the “Live App Settings” section. There are a few settings we’ll need to adjust here.

Note: PayPal recently modfied their app permissions to require a special request in order to access details that Social Login requires in order to create an account on behalf of the customer. Our development team is currently investigating alternatives, but for the time being it will be necessary to reach out to PayPal at help-loginappreview@paypal.com to request special permission for your app.
  1. Under Return URLs, enter the App Redirect URL. The App Redirect URL is listed under WooCommerce > Settings > Social Login > PayPal. It will probably look something like this:
    http://MYSTORE.com/?wc-api=auth&done=paypal

    BUT MAY BE DIFFERENT. Please refer to the plugin settings for this. You can use the same redirect URL for both live and sandbox PayPal apps.

  2. Under App feature options, only enable “Log in with PayPal”, and disable other features.
    WooCommerce Social Login PayPal app settings 1
  3. Under “Log In with PayPal”, we need to click “advanced options” and change a few settings:
    • click “customize” for “Personal Information” and only enable “Full Name”
    • Enable “Address Information”
    • Click “customize” for links shown to the customer, and enter the links to your Privacy Policy and Terms & Conditions pages
  4. This is highly recommended but not required: uncheck / disable “Allow the customers who haven’t yet confirmed their email address with PayPal, to log in to your app.”

WooCommerce social Login: PayPal login scope

Click “Save” and confirm the changes you’ve made. Now we can copy API credentials to over to the plugin settings. At the top of the page, scroll up to “Live API Credentials”. Copy the Client ID and Secret (you may have to click “Show”), then enter them under WooCommerce > Settings > Social Login > PayPal and save your settings.

WooCommerce Social Login PayPal app credentials

Connecting Instagram ↑ Back to top

Instagram has updated requirements to making a login app, which (we’ll warn you in advance!) makes this a pain to set up. If you want to allow Instagram login, the instructions are as follows, but this does take some time.

To connect your WooCommerce store to Instagram, visit the Instagram Developer Center and log into your Instagram account. Click “Manage Clients” next your profile info:

WooCommerce social login Create Instagram Apps
Create Instagram Apps

If this is the first time you are adding an app or plugin, Instagram will ask you a few questions. You can enter these responses:

  • Your website: Enter your website’s home URL
  • Phone number: Enter your phone number (they won’t call you)
  • What do you want to build with the API? A plugin for my WordPress website.

Click “Sign Up”, and then click “Manage Clients” again. You’ll now be able to “Register a New Client” by clicking the button:

WooCommerce social login Instagram register client
Register Client

You’ll be taken to the “register client” form next. You should enter your store name for the Application name and complete the additional fields. The URL you should enter in Valid Redirect URIs is listed under WooCommerce > Settings > Social Login > Instagram as the “OAuth redirect_uri”. It will probably look something like this:

http://MYSTORE.com/?wc-api=auth&done=instagram

BUT MAY BE DIFFERENT. Please refer to the plugin settings for this.

WooCommerce Social Login Instagram New App
New App

Under the “Security” Tab, leave “Disable Implicit OAuth” enabled and “Enforce Signed requests” unchecked.

WooCommerce Social Login: Instagram app creation, step 2

You can now enter the captcha and click “Register”. This will provide you with your Client ID and Client Secret, which you need to copy.

WooCommerce Social Login: Instagram app creation, step 3

You can now enter these credentials under WooCommerce > Settings > Social Login > Instagram and save your settings. This will enable Sandbox testing for your app. Set up is not completed yet. You can only test with your own Instagram account.


To set your app live, you must submit it for approval to Instagram. Click “Edit” for your application, and go to the “Permissions” tab. Here you can submit your app for approval by Instagram.

WooCommerce Social Login: Instagram app creation, step 4

This will take you to the submission form, where you must include a description of what your app does, and a screencast of the app in action on your site. Here is a sample description you can use:

My app uses the Instagram API to allow social login on my eCommerce website. Customers can link their accounts on my website to their Instagram accounts for fast, secure, and easy log in with Instagram. This also uses the customer's Instagram profile picture on the website for blog comments or other interaction.

WooCommerce Social Login: Instagram app creation, step 5

We recommend using your own screencast URL of the plugin in action on your site, as this most likely to be approved by Instagram. If you have no capability to make your own screencast, then our demo plugin screencast could be used as a (not-recommended) backup:

http://cl.ly/2N30432c2V3O

Once you’ve completed this form, click “Submit” to submit your app for review. This will submit the app, and it will not be live until reviewed and approved by Instagram.

In February 2016, we went through this process ourselves for our test apps, and had our demo site app approved. In our experience, the timeline should take 1-2 weeks, but your experience may vary.

Connecting Disqus ↑ Back to top

To connect your WooCommerce store to Disqus, you must register a Disqus application. Go to Disqus API Resources / Applications and sign in.

Click on “register an application” under the “Applications” tab.

WooCommerce Social Login Disqus login step 1

Complete the fields to register your application by entering a label for your application (for your reference), the description of what your application does, your business name, and your website. When you’ve entered these details, click “Register my application”.

WooCommerce Social Login Disqus login step 2
Create application

While editing your application under Application > Settings, you must now change two settings:

  1. In the “Domains” field, enter the URL of your WooCommerce site / store
  2. Under “Authentication”, change “Default access” to “Read only”
  3. Optional: If you want to show your logo to visitors when they authorize your site to use Disqus log in, you can set your icon here as well. Any other settings here can be completed, but are not required.
WooCommerce Social Login Discus Login step 3
Set Domains & Access

Save your settings, and go to Application > Details.

WooCommerce Social Login Disqus login step 4
View app details

Scroll down to “OAuth” settings. Copy your API Key and API Secret, and paste these into the plugin settings.

WooCommerce Social Login Disqus login step 5
Get API Key / Secret

Once you’ve saved the plugin settings, Disqus login will now be enabled.

Connecting Yahoo ↑ Back to top

To connect your WooCommerce store to Yahoo, you must create a Yahoo application. Go to Yahoo Developer Network and create an account (or sign in if you have an existing Yahoo account — it doesn’t have to be a developer account).

Once you’re signed into Yahoo, go to Create an App. This will let you enter fields for your app:

  • Application Name – enter any name that users of your website will recognize
  • Application Type – Web Application
  • WooCommerce Social Login Yahoo login step 1
    Create app
  • Callback Domain – your website’s home URL, i.e., mysite.com
  • API Permissions – Check the “Profiles (Social Directory)” option, then choose the “Read/Write Public and Private” radio button
WooCommerce Social Login Yahoo login step 2
Change permissions

Once you’ve completed these fields, click “Create App”. You’ll see a success message that provides a Client ID and Client Secret.

WooCommerce Social Login Yahoo Login step 3
Get Client ID and Secret

Enter these in the app settings to finish enabling Yahoo Login.

Connecting VK ↑ Back to top

To connect your WooCommerce store to VK.com (Vkontakte), you must create an application via VK.

Log into VK and first check your profile settings — you must have a mobile phone number capable of receiving SMS messages specified under “Your Phone Number”. When you create an application, a security code will be sent to that phone.

Once you’ve confirmed this, go to Create an Application and fill in the form provided.

  • Title – Enter any name that users of your website will recognize
  • Category – Select “Website”
  • Site address – This is the URL of your website, http://www.example.com/
  • Base domain – Enter only your site’s domain name: example.com
WooCommerce Social Login VK Login step 1
Create Application

Once you’ve completed this form, click “Connect Site”. This will open the dialog box to send a confirmation code to your mobile phone. Once you’ve gotten the SMS message, enter your confirmation code.

WooCommerce Social Login VK Login step 2
Enter confirmation number

After confirming with your code, you’ll be taken to the application screen. Click “Settings” on the left side to get your Application ID and Secure Key. Enter these in the plugin settings to complete set up.

WooCommerce Social Login VK step 3
Get API ID / Key

Setup FAQ ↑ Back to top

Q: Facebook is requiring other fields and I’m getting some weird errors.
A: Sometimes Facebook creates the app incorrectly. Please ensure that you’ve added a Platform under settings. If you have, delete the app and begin again, and this should resolve what you’re seeing.


Q: Why can’t I get the Amazon login to work?
A: You must have an SSL on your site, or this won’t work, as it’s required by Amazon. The Amazon setup is a bit involved, so please be sure that you’ve followed all steps for registering your security profile. Not going through this process is the most common issue we see with Amazon setup.


Q: What information is accessible for each network?
A: We have a chart that displays info received from each network. The plugin doesn’t send data from users or your store anywhere external since you’re creating and managing your own app.


Q: I get an error when trying to use PayPal login that says, “Relying Party Validation error: client_id provided in the request does not match any of the registered clients. Please check the request.”
A: This is most likely because you’re using a PayPal personal account. Please sign up for a free PayPal business account as described in the PayPal section and you’ll be able to obtain live PayPal credentials.

User Documentation ↑ Back to top

Now that you’ve created your social network apps, you can visit the user documentation to finish setup.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top