Start Strong
Sell Smart
Manage with Ease
Market to Success

Enabling Customer Login with a Facebook Account

SHOPLINE offers a convenient Facebook login integration, allowing customers to quickly sign up for or log in to your store using their Facebook account. This feature, powered by Facebook, requires a dedicated Facebook App to be installed for your store. Therefore, before configuring the Facebook login within SHOPLINE, you will first need to create and set up this app on the Facebook platform.

Follow this guide to learn how to create and configure your Facebook App for seamless integration with your SHOPLINE store.

Note: Facebook's settings may change over time due to platform updates. If you encounter any issues during the setup process, please contact SHOPLINE Support for assistance.

 

 

Creating and Configuring Your Facebook App

This section provides step-by-step instructions for creating a Facebook app and obtaining the necessary App ID and App secret to enable Facebook Login for your SHOPLINE store.

Step 1: Access Facebook for Developers

  1. Navigate to Facebook for Developers and log in using your personal Facebook account.

  2. In the upper-right corner, click My Apps.

  3. Click Create App to begin the app creation process.

Step 2: Create Your Facebook App

  1. Enter your desired App name and confirm your App contact email. Then, click Next.

  2. In the Add use cases section, select Authenticate and request data from users with Facebook Login, then click Next.

  3. Select the business portfolio you want to associate with this app and click Next.

  4. In the Publishing requirements section, review the required items, then click Next to continue.

  5. On the Overview page, review your app details, selected use case, associated business portfolio, and publishing requirements. Then, click Create app to finish creating your app.

  6. Once your app is created, you'll be redirected to the app’s Dashboard section to continue the setup.

Step 3: Customize App Settings for Facebook Login

  1. On the Dashboard, go to App customization and requirements and click Customize the Authenticate and request data from users with Facebook Login use case.

  2. Under Facebook Login, click Settings.

  3. In the Client OAuth Settings section, enable the following options:

    • Client OAuth login
    • Web OAuth login
    • Enforce HTTPS
    • Use Strict Mode for redirect URIs

  4. In the Valid OAuth Redirect URIs field, enter the URL(s) of your store’s login page. The required URL depends on whether you are using the Classic customer account, New customer account, or both.

    Classic customer account

    Append "/user/signIn" to your store domain. For example: 

    • If your store domain is: https://abcd.myshopline.com

      Your login URL will be: https://abcd.myshopline.com/user/signIn

    • If you use a custom domain: https://abcd.wxyz.com

      Your login URL will be: https://abcd.wxyz.com/user/signIn

    New customer account

    Append "/account/signIn" to your store domain. For example:

    • If your store domain is: https://abcd.myshopline.com

      Your login URL will be: https://abcd.myshopline.com/account/signIn

    • If you use a custom domain: https://abcd.wxyz.com

      Your login URL will be: https://abcd.wxyz.com/account/signIn

    If both Classic and New customer accounts are enabled

    Enter both login URLs in the field, placing each URL on a separate line (use the Enter key to separate them).

    Note: The URLs above are examples only. Please make sure to replace them with your actual store URL. You may refer to your store’s homepage URL as a reference.

  5. Click Save Changes.

    Note: After saving, verify that Use Strict Mode for Redirect URIs remains enabled. If it turns off, re-enable it and save again.

  6. Go to Facebook Login > Permissions and features, locate email, and click + Add to grant access to the user's primary email address.

    Note: For information on requesting permission to access a user's email address, please refer to Facebook’s official documentation.

Step 4: Submit Your App for Review

To complete the necessary verification steps:

  • (Optional) On the app dashboard, go to Review > Testing and complete the testing procedures as prompted.

  • (Required) Go to Review > Verification, click Start verification, and follow the on-screen instructions to verify your business.

Once the required verifications are complete, go to the Publish page and click the Publish button in the bottom-right corner. When the Publish section in the left-hand menu shows Published, your app is live.

Step 5: Configure Basic App Settings

Go to App settings > Basic. Then, complete the fields with your store's information.

Note: Ensure you use your store's privacy policy URL, not the generic SHOPLINE privacy policy link.

Step 6: Finalize Setup in SHOPLINE

Copy the App ID and App secret, then return to your SHOPLINE admin panel to complete the Facebook Login configuration using the copied credentials.

 

 

Enabling Login with Facebook in the Admin Panel

Steps in SHOPLINE Admin

Follow the steps below to enable login with Facebook for your store:

  1. In your SHOPLINE admin panel, go to Settings > Customer account > General settings.

  2. In the Login through social media section, find the Facebook login option and click Link

  3. In the pop-up window, enter the copied App ID and App Secret, then click Save to complete the activation.

  4. The Facebook login option will then display a Linked status. Based on your business needs, choose whether to enable third-party login for the Classic customer account, the New customer account, or both in the Account type section.

You've completed the setup. Now, test the feature on your storefront.

Testing Facebook Login 

Access the sign-up/login page of your store and click the Facebook Sign-Up/Login icon. This will prompt customers to log in to their Facebook accounts and grant authorization to your app (the app name and icon will appear).

2.2.1_display.png

Note: Customers must grant access to their Facebook profile to use the login feature.

Account Handling During Facebook Login

When a customer logs in with Facebook, the system handles their account based on whether an email address is available and whether it matches an existing customer record.

First-time login

  • Email granted, account exists: If the customer's Facebook-authorized email address matches an existing account in your store, they will be automatically logged in to that existing account. No duplicate account is created.
  • Email granted, no existing account: If the email address does not match any existing account, a new account is created with that email address linked.
  • Email not granted: If the customer does not authorize access to their email address, a new account is created using their Facebook ID. No email address is linked.

Returning login

  • Email granted, account has no email, email not in use: If the customer authorizes access to their email address and the current account does not yet have an email, and the email is not already associated with another account, the authorized email will be added to the account.
  • Email granted, account has no email, email already in use: If the customer authorizes access to their email address but the email is already associated with another account, the email will not be added, and the customer will proceed to log in.
  • Email granted, account already has an email: If the customer authorizes access to their email address and the current account already has an email, the existing email will not be overwritten, and the customer will proceed to log in.
  • Email not granted: If the customer does not authorize access to their email address, the customer will proceed to log in, and no updates will be made to the account information.