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.
Connecting Facebook ↑ Back to top
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.
Enter your app name + an email address for your store:
Choose “Facebook Login” for the app type, and click “Set Up”:
Do not use the “Quickstart” you’ll be taken into; instead, click “Settings > Basic” for the app:
Click “Add platform”, and then select “Website” as your platform.
Now enter the rest of the basic details for your store. You can
- set the display name (the name of your store; will be shown to customers when they approve app access to log in),
- set a namespace (an optional identifier – helpful for subdomains but not needed),
- set “category” to whatever you’d like,
- and optionally add site URLs and a logo.
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
Last step! Go to “App Review” and change the app status to live / public (or do so from your top bar):
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.
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”:
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:
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.
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.
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:
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”:
Enter your project’s name (this is shown to customers to approve the login) and click “Create”:
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.
Now go to the “Credentials” tab and click “Create credentials”. You’ll select “OAuth client ID” for the type.
Select “Web application” for your application type, and complete the application fields.
The “Authorized Redirect URI” is listed under WooCommerce > Settings > Social Login > Google. It will probably look something like this:
BUT MAY BE DIFFERENT. Please refer to the plugin settings for this.
Click “Create” to save this setup and generate your credentials. You can copy these credentials and save them under WooCommerce > Settings > Social Login > Google.
Connecting Amazon ↑ Back to top
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.
- Go to Login With Amazon (click this link, or go to “Apps & Services”, then “Login with Amazon”). Click “Create a New Security Profile”:
Once your profile has been created, go to Settings > Web Settings in the bottom right (the cog icon):
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:
BUT MAY BE DIFFERENT. Please refer to the plugin settings for this. Note that the URL MUST be https://.
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.
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”.
Fill out the application form with your store’s information. For Application Use, select “Other”.
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”.
Now go to the “Authentication” page you were first at. Under Default Application Permissions, choose
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:
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
If you do not have a business account, you won’t be able to access live credentials:
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.
You can then enter a name for your app and click “Create App” again.
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.
- 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:
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.
- Under App feature options, only enable “Log in with PayPal”, and disable other features.
- 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”
- 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.”
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.
Connecting Instagram ↑ Back to top
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:
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:
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:
BUT MAY BE DIFFERENT. Please refer to the plugin settings for this.
Under the “Security” Tab, leave “Disable Implicit OAuth” enabled and “Enforce Signed requests” unchecked.
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.
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.
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.
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:
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.
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.
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”.
While editing your application under Application > Settings, you must now change two settings:
- In the “Domains” field, enter the URL of your WooCommerce site / store
- Under “Authentication”, change “Default access” to “Read only”
- 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.
Save your settings, and go to Application > Details.
Scroll down to “OAuth” settings. Copy your API Key and API Secret, and paste these into the plugin settings.
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
- 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
Once you’ve completed these fields, click “Create App”. You’ll see a success message that provides a Client ID and Client 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
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.
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.
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.