Articles on: Users management

Facebook login

Let your users sign in with Facebook


Social login lets your marketplace visitors create an account and log in with one click, using their Facebook account — no password to remember, no activation email to wait for. This guide walks you through creating a Facebook app and enabling it on your marketplace.


What you'll need


  • Admin access to your marketplace (/admin)
  • A Facebook account with access to Meta for Developers
  • About 10 minutes


Good to know: each marketplace uses its own Facebook app. Your credentials are never shared with other marketplaces, and the consent screen shows your marketplace's name and icon.



Step 1 — Copy your callback URL from your admin


  1. In your marketplace admin, go to Settings → Social login (or press Cmd/Ctrl + K and type "social").
  2. In the Facebook section, copy the redirect URI shown in the blue box. It looks like:


      https://your-marketplace.com/auth/facebook/callback
  


   Keep this page open — you'll come back to it at the end.


[Screenshot: the Facebook section of Settings → Social login, with the redirect URI highlighted]


Step 2 — Create a Facebook app


  1. Open developers.facebook.com and log in.
  2. Go to My Apps → Create App.
  3. When asked for a use case, choose Authenticate and request data from users with Facebook Login.
  4. Choose Consumer as the app type if prompted.
  5. Give the app your marketplace's name, enter your contact email, and click Create app.


[Screenshot: Meta "Create an app" flow with the Facebook Login use case selected]


Step 3 — Configure Facebook Login


  1. In your app dashboard, open Facebook Login → Settings (add the Facebook Login product first if it isn't there yet).
  2. In Valid OAuth Redirect URIs, paste the callback URL you copied in Step 1.
  3. Leave Client OAuth login and Web OAuth login enabled.
  4. Save changes.


[Screenshot: Facebook Login settings with the Valid OAuth Redirect URIs field filled]


Custom domain? If your marketplace is reachable on several domains (e.g. mymarket.kreezalid.com and www.mymarket.com), add one redirect URI per domain, each ending in /auth/facebook/callback.


Step 4 — Fill in the app's public details and go Live


Facebook only lets real users log in once your app is in Live mode, and Live mode has a few requirements:


  1. Go to App settings → Basic and fill in:
       - App icon and Category
       - Privacy policy URL — your marketplace's privacy policy page (required)
       - User data deletion — your contact URL or instructions (required)
  2. Make sure the email permission is available: in App Review → Permissions and features, email and public_profile have standard access by default for the app's own login — no review needed.
  3. Switch the toggle at the top of the dashboard from Development to Live.


[Screenshot: Basic settings with privacy policy filled, and the Live toggle switched on]


Step 5 — Enable Facebook login on your marketplace


  1. In App settings → Basic, copy the App ID and the App secret (click Show).
  2. Back in your admin, on Settings → Social login:
       - Toggle Enable Facebook login on
       - Paste the App ID
       - Paste the App secret
  3. Save.


[Screenshot: Facebook section filled in, toggle on]


That's it! A Continue with Facebook button now appears on your /login and /register pages.



How it works for your users


  • New visitor: clicking the button creates their account instantly — it is activated right away (no confirmation email needed) and they receive your welcome email.
  • Existing user: if the Facebook email matches an existing account, they are simply logged in.
  • If your signup form requires extra information (custom fields, company name…), the user is asked to complete their profile right after their first sign-in.
  • Facebook accounts without an email address (accounts created with a phone number only) cannot use social login: the user is politely redirected to the classic registration form.


Troubleshooting


Problem

Likely cause

The button doesn't appear on /login

The toggle is off, or the App ID / secret is empty. All three are required.

"URL blocked: this redirect failed"

The redirect URI in the Facebook app doesn't exactly match the one in your admin (check https://, the domain, and the /auth/facebook/callback path).

"App not active" / only you can log in

The app is still in Development mode — switch it to Live (Step 4).

Facebook asks for privacy policy / data deletion

Both fields in App settings → Basic are mandatory before going Live.

Users are asked to complete their profile

Expected: your default user group has required signup fields that Facebook can't provide.

Updated on: 21/07/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!