Appearance
GitLab authentication
GitLab authentication lets your users sign in with the GitLab account they already use for code and projects. Once connected, you can offer “Continue with GitLab” in your WeWeb app.
What this integration supports
- Social sign in with GitLab
- Redirect to different pages for success, error, and first-time users
Setup in the GitLab dashboard
- Sign in to GitLab and open your profile settings.
- Go to
Applications(sometimes underPreferences). - Create a new application.
- Add a redirect URL (the URL GitLab sends users back to after login).
- Use the full URL of the page you select as
Success pagein WeWeb.
- Use the full URL of the page you select as
- Save the application and copy the values GitLab provides:
Application ID(Use this asClient IDin WeWeb)Secret(Use this asClient Secretin WeWeb)
Connect GitLab in WeWeb
- In the WeWeb editor, go to
Data & API → Auth → Integrating providers. - Select
GitLaband turn on theEnabletoggle. - Paste the credentials into the fields shown in WeWeb (
Client IDandClient Secret). - Click
Save.
Test sign in
- In
Interface, add a “Continue with GitLab” button. - Create a workflow on click and add
Sign in with social provider. - Set:
Provider:gitlabSuccess page,Error page, And (optional)New user page
- Preview and complete the GitLab sign-in flow.
Common pitfalls
Redirect URL mismatch
Make sure the redirect URL in GitLab exactly matches the Success page URL you selected in WeWeb (including https:// and any path).
Using the wrong GitLab host
If you use a self-hosted GitLab instance, make sure you created the application in the correct GitLab environment (not on gitlab.com).
Reference
| Setting in WeWeb | Description | Where to find it in GitLab |
|---|---|---|
Client ID | Identifies your GitLab application. | Applications page (Application ID). |
Client Secret | Used to complete the sign-in flow securely. | Applications page (Secret). |
FAQs
Which redirect URL should I add in GitLab?
Use the full URL of the page you select as Success page in Sign in with social provider.

