Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.
This page documents workspace-level SSO for your team’s access to Lovable itself. It is configured at the workspace level under Identity (Workspace settings → Access → Identity).Looking for SAML SSO for the end users of your app? See Add SAML single sign-on to your app. Want apps you build to recognize logged-in workspace members without a login page? See Reuse Lovable workspace identity in your app. Both are different features.
Single sign-on (SSO) is available on Business and Enterprise plans and enables secure, centralized authentication across your company. With SSO, users can access Lovable with one set of credentials, simplifying access management and improving security.
Service provider (SP)-initiated login is supported for all providers: users start login from Lovable.Identity provider (IdP)-initiated SSO (starting from an IdP dashboard tile) can optionally be enabled for SAML providers. See Set up IdP-initiated login (SAML). OIDC providers support SP-initiated login only.
If your workspace belongs to an organization, an org admin can set up SSO once for every workspace. See Set up SSO for the organization. If the workspace is Managed by the organization, its Identity tab shows that the organization manages these settings.
Supported SSO protocols
Lovable supports both OIDC and SAML 2.0 protocols, enabling integration with all major identity providers (IdP) including Okta, Auth0, Microsoft Entra ID (Azure AD), and more.
OpenID Connect (OIDC): recommended. A modern identity layer built on OAuth 2.0 that verifies who is logging in.
SAML (Security Assertion Markup Language) 2.0: XML-based protocol for exchanging authentication and authorization data, widely used in enterprise environments.
Prerequisites
To connect your identity provider to Lovable using OIDC or SAML, you need:
Admin access to your identity provider
Workspace owner or admin role in Lovable
A verified domain in Lovable, to prove domain ownership
To verify your domain, add the TXT record displayed in the UI to your DNS provider. See Verify a domain for your workspace for the full walkthrough, including record details and troubleshooting.
Start SSO setup in Lovable
SSO configuration is a two-way setup between Lovable and your identity provider:
Lovable → IdP: copy Lovable URLs and settings into your IdP app.
IdP → Lovable: copy your IdP’s issuer, metadata, and certificates back into Lovable.
The workspace owner or admin can set up SSO. To start, go to Identity (Workspace settings → Access → Identity) and click Add provider in the SSO providers section. On the Choose SSO Protocol screen, click Configure OIDC or Configure SAML.
Add provider stays disabled until your workspace has a verified domain and shows Add a verified domain first. Add one in the Verified domains section, then start SSO setup.
The setup then runs in three stages:
Preparation. Lovable shows what to configure in your IdP, such as the app type, scopes, and attribute mappings, and the Lovable URLs to copy into your IdP. The values are listed in the reference below.
Configuration. You enter your IdP’s issuer and client credentials or certificates, a display name, and the verified domain your login URL is based on. The provider guides below list the exact fields.
Test and confirm. For OIDC, Test configuration checks your values before you continue. Both protocols end on a confirmation page where you click Confirm & enable SSO.
IdP configuration reference
Use these values while configuring OIDC or SAML in your IdP. Lovable shows the same values on the preparation screens, with copy buttons on the URLs.
OIDC
SAML
Application type: Web Application or Server-side Application
Grant type: Authorization Code
Token method: POST (if configurable)
Redirect URI to copy and add to your IdP: https://auth.lovable.dev/__/auth/handler
OAuth scopes:
Required: openid, email
Recommended: profile
Optional claims: department, title, division, manager, for the member’s department, job title, division, and manager’s display name. Lovable also accepts departmentName, jobTitle, managerDisplayName, and managerName. Claim names are case-sensitive. Lovable shows the department in Insights.
displayName (recommended): map to user’s full name
photoURL (recommended): map to user’s profile picture URL
department, title, division, manager (optional): map to the member’s department, job title, division, and manager’s display name. Lovable also accepts departmentName, jobTitle, managerDisplayName, and managerName. Attribute names are case-sensitive. Lovable shows the department in Insights.
Email is not a separate attribute. Lovable reads it from the Name ID, so the Name ID source must be the user’s email address, not a login identifier.
Protocol settings:
Name ID format: EmailAddress
Signature algorithm: RSA-SHA256
SAML binding: HTTP-POST
Response signed: yes
Your SSO login URL
Each provider gets a login URL that members can use to log in with SSO directly: https://lovable.dev/sso-login/{tenantId}. The {tenantId} part is your verified domain with dots replaced by hyphens, for example acme-com for acme.com. If you enter a Login URL suffix during setup, Lovable appends it, for example acme-com-engineering. Login identifiers are unique across Lovable, so a second workspace on the same domain needs a suffix. After setup, the URL appears in the SSO providers row and in the provider’s Login URL field, each with a copy button.
Enforce SSO
Enforce SSO requires an active SSO session to use the workspace. Members who log in another way are asked to log in through your provider before they can access it. The toggle in Identity (Workspace settings → Access → Identity) becomes available when your workspace has a verified domain and an SSO provider. Test an SSO login before you enable it: for six hours after you add a provider, the toggle stays disabled and shows Wait 6 hours and test SSO login before enforcing SSO.If your SSO provider is Google, members log in once. A member who selects Continue with Google and uses a Google Workspace account on your verified domain gets an SSO session from that login, so Lovable does not ask them to log in again.A member still needs a separate SSO login when:
The member logs in with a personal Google account instead of one your Google Workspace manages.
Your SSO provider is not Google. Google SAML and Google OIDC both count, and other providers such as Okta, Auth0, and Microsoft Entra ID do not.
Your provider uses Group restriction, because a Google login sends no group claims.
Another workspace on your verified domain also uses a Google SSO provider.
These logins appear in your audit logs as SSO workspace access, so you keep the same record of who logged in.When you enable the toggle, Lovable opens the Enable enforce SSO dialog:
Keep Remove all external collaborators selected and click Enable and remove to remove external collaborators from every project in the workspace.
While SSO is enforced, invite links only work for people whose email is on one of your verified domains.Use Session duration to choose how long members stay logged in before Lovable requires a new SSO login:
8 hours, 24 hours, 48 hours, 7 days, or 30 days: members log in through SSO again when that time has passed.
Indefinite: the SSO login has no time limit, so Lovable does not ask members to log in through SSO again. A workspace uses Indefinite until you choose a length.
You cannot enable Enforce SSO while Require two-factor authentication is set to Everyone. Set it to External collaborators to keep requiring 2FA from external collaborators, or to Off to drop the requirement. Under enforced SSO, Lovable does not ask members for a second factor, so require one in your identity provider.
Provider-specific setup guides
If you use Okta, Auth0, or Microsoft Entra, you can find provider-specific documentation for setting up SSO. If you use another provider, see Configure other providers.Before you begin, complete Start SSO setup in Lovable to get the settings and values you need to use in your IdP.For more information, refer to your IdP’s official documentation.
Configure Okta as your SSO provider
OIDC
SAML
1
Add the Lovable app in Okta
In the Okta Admin Console, go to Applications → Browse App Catalog.
Search for Lovable, then click Add Integration.
On the General Settings screen, set the Application label (for example, Lovable OIDC), then click Next.
On the Sign-On Options screen, select OpenID Connect.
Set Application username format to Email.
Click Done.
2
Provide Lovable with your IdP information
In Okta, copy the following values from the Sign On tab and enter them in Lovable.
To find your issuer, click the OpenID Provider Metadata link on the Sign On tab. The issuer is your Okta domain, for example https://your-org.okta.com.
Okta Client ID → Lovable OAuth Client ID / Application ID
Okta Client Secret → Lovable OAuth Client Secret
Optionally, the date the client secret expires → Lovable Client secret expiration (optional)
3
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
4
Test the configuration in Lovable
In Lovable, click Test configuration. Lovable checks the issuer, client ID, and client secret and shows the outcome on the Test results screen. Fix anything it reports, then click Configure provider.
5
Finish OIDC provider configuration in Lovable
In Lovable, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Okta as your OIDC SSO provider.
1
Add the Lovable app in Okta
In the Okta Admin Console, go to Applications → Browse App Catalog.
Search for Lovable, then click Add Integration.
On the General Settings screen, set the Application label (for example, Lovable SAML), then click Next.
On the Sign-On Options screen, select SAML 2.0.
Set Application username format to Email.
Click Done.
The SAML settings (ACS URL and Audience URI) are pre-configured by the Lovable integration. You do not need to enter any SAML values manually in Okta.Because these settings cannot be changed, the catalog app does not support IdP-initiated login yet. For now, users logging in through Okta must start login from Lovable.
2
Provide Lovable with your IdP information
In Lovable, choose between quick SAML provider setup or manual configuration:Option 1: Quick setup - import from metadata URL
In Okta, open the Sign On tab of the Lovable application, scroll to Metadata details, and copy the Metadata URL.
In Lovable, paste the metadata URL in Quick setup: import from metadata URL field.
Click Test & import to automatically populate the required fields below.
Option 2: Manual configurationOpen the metadata URL in a new tab. Copy the following values and enter them in Lovable.
Paste the certificate value between the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines.
3
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
4
Finish SAML provider configuration in Lovable
In Lovable, click Configure SAML provider, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Okta as your SAML SSO provider.
Configure Auth0 as your SSO provider
OIDC
SAML
1
Create an application in Auth0
Go to Auth0 Admin Dashboard → Applications.
Click Create application. Select the Regular Web Applications application type.
Give the app a name, for example Lovable OIDC SSO.
Click Create.
2
Configure Allowed Callback URLs
In Auth0, go to your application settings.
Add the Allowed Callback URLs: https://auth.lovable.dev/__/auth/handler
Click Save.
3
Provide Lovable with your IdP information
In Auth0, copy the following values from the Settings tab and enter them in Lovable.
Auth0 Client ID → Lovable OAuth Client ID / Application ID
Auth0 Client Secret → Lovable OAuth Client Secret
Optionally, the date the client secret expires → Lovable Client secret expiration (optional)
4
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
5
Test the configuration in Lovable
In Lovable, click Test configuration. Lovable checks the issuer, client ID, and client secret and shows the outcome on the Test results screen. Fix anything it reports, then click Configure provider.
6
Finish OIDC provider configuration in Lovable
In Lovable, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Auth0 as your OIDC SSO provider.
1
Create an application in Auth0
Go to Auth0 Admin Dashboard → Applications.
Click Create application. Select the Regular Web Applications application type.
Give the app a name, for example Lovable SAML SSO.
Click Create.
2
Configure Allowed Callback URLs
In Auth0, go to your application settings.
Add the Allowed Callback URLs: https://auth.lovable.dev/__/auth/handler
Click Save.
3
Configure SAML2 Web App Add-on
In Auth0, navigate to Addons, and enable SAML2 Web app.
In Lovable, choose between quick SAML provider setup or manual configuration:Option 1: Quick setup - import from metadata URL
In Auth0 → Addon: SAML2 Web app → Usage, locate the Identity Provider Metadata, and click the arrow icon to get the URL.
In Lovable, paste the metadata URL in Quick setup: import from metadata URL field.
Click Test & import to automatically populate the required fields below.
Option 2: Manual configurationIn Auth0 → Addon: SAML2 Web app → Usage, copy the following SAML Protocol Configuration Parameter values and enter them in Lovable.
Download Auth0 certificate and copy the X509Certificate value. Paste the certificate value between the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines.
5
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
6
Finish SAML provider configuration in Lovable
In Lovable, click Configure SAML provider, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Auth0 as your SAML SSO provider.
In the Add from the gallery section, search for Lovable, select it in the results, and add it to your tenant.
Open the app, go to Single sign-on, and select Go to application to open the app’s registration.
Adding Lovable from the gallery replaces creating your own app registration. You still add the redirect URI, grant the permissions, and create a client secret in the steps below.
2
Add the Lovable redirect URI
In the app’s registration, go to Authentication.
In Redirect URIs, add https://auth.lovable.dev/__/auth/handler.
Click Configure.
The URL must match exactly, including the https:// protocol.
3
Configure the optional claims
In Microsoft Entra, go to Token configuration → Add optional claim.
Select ID token and add the email claim.
Click Add.
Lovable requires an email address in the ID token and has no fallback to the user principal name (UPN), so login fails for users whose token carries no email claim.
4
Configure the API permissions
In Microsoft Entra, go to API permissions, and check that the Microsoft Graph delegated permissions Lovable needs are listed:
email
openid
profile
To add any that are missing, click Add a permission → Microsoft Graph → Delegated permissions, select them, then click Add permissions.
Click Grant admin consent.
5
Create a client secret
In Microsoft Entra, go to Certificates & secrets → Client secrets → New client secret.
Enter a description, choose an expiry, and click Add. Note the expiration date so you can record it in Lovable.
Copy the secret Value immediately. It isn’t shown again after you leave the page.
6
Provide Lovable with your IdP information
In Lovable, enter the following:
OIDC Issuer URL / Discovery Endpoint: format the URL as https://login.microsoftonline.com/{TENANT_ID}/v2.0
Replace the {TENANT_ID} with the Directory (tenant) ID from the Overview page in Microsoft Entra.
Microsoft Entra Application (Client) ID, from the Overview page → Lovable OAuth Client ID / Application ID
The Microsoft Entra Client secret value you copied → Lovable OAuth Client Secret
Optionally, the date the client secret expires → Lovable Client secret expiration (optional)
7
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
8
Test the configuration in Lovable
In Lovable, click Test configuration. Lovable checks the issuer, client ID, and client secret and shows the outcome on the Test results screen. Fix anything it reports, then click Configure provider.
9
Finish OIDC provider configuration in Lovable
In Lovable, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Microsoft Entra ID as your OIDC SSO provider.
1
Create an enterprise app in Microsoft Entra ID
Go to Microsoft Entra ID admin center → Enterprise applications, and select New application.
Select Create your own application and choose Integrate any other application you don’t find in the gallery (Non-gallery).
Give the app a name, for example Lovable SAML SSO.
Click Create. Your application is now created.
2
Configure SAML SSO
In Microsoft Entra, navigate to the Single sign-on setup page and select SAML. Under Basic SAML Configuration, enter the following:
Reply URL (Assertion Consumer Service URL): https://auth.lovable.dev/__/auth/handler
Leave the other values blank and select Save.
To let users log in to Lovable from the Microsoft My Apps portal, add a second Reply URL (Assertion Consumer Service URL): https://api.lovable.dev/sso/saml/idp-consume, and select it as the Default reply URL. See Set up IdP-initiated login (SAML) for requirements.
3
Provide Lovable with your IdP information
When the application is set up in Microsoft Entra, you can choose between quick SAML provider setup or manual configuration in Lovable.Option 1: Quick setup - import from metadata URL
In Microsoft Entra, go to SAML Certificates and copy the App Federation Metadata URL.
In Lovable, paste the App Federation Metadata URL in Quick setup: import from metadata URL field.
Click Test & import to automatically populate the required fields below.
Option 2: Manual configurationCopy the following values in Microsoft Entra and enter them in Lovable.
Microsoft Entra Login URL → Lovable SAML SSO Sign-on URL (from your IdP)
Microsoft Entra Microsoft Entra Identifier → Lovable Identity Provider Entity ID / Issuer
Microsoft Entra X509Certificate → Lovable X.509 signing certificates
You can download the certificate (Base 64) or open the App Federation Metadata URL in a new tab and copy the X509Certificate value. Paste the certificate value between the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines.
4
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
5
Finish SAML provider configuration in Lovable
In Lovable, click Configure SAML provider, review the confirmation page, then click Confirm & enable SSO to finish the configuration of Microsoft Entra ID as your SAML SSO provider.
Configure other providers
You can configure any OIDC or SAML-compliant provider with Lovable SSO.Before you begin, complete Start SSO setup in Lovable to get the settings and values you need to use in your IdP.
OIDC
SAML
Provider mappingCommon field names across providers:
Client ID → Lovable OAuth Client ID / Application ID
Client Secret → Lovable OAuth Client Secret
Optionally, the date the client secret expires → Lovable Client secret expiration (optional)
5
Configure the display name and login URL
In Lovable, fill in the remaining fields:
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
6
Test the configuration in Lovable
In Lovable, click Test configuration. Lovable checks the issuer, client ID, and client secret and shows the outcome on the Test results screen. Fix anything it reports, then click Configure provider.
7
Finish OIDC provider configuration in Lovable
In Lovable, review the confirmation page, then click Confirm & enable SSO to finish the configuration of your OIDC SSO provider.
Provider mappingCommon field names across providers:
ACS URL: Single Sign-On URL, SSO URL, Reply URL, Assertion Consumer Service URL
Audience: SP Entity ID, Audience URI, Identifier
Attribute mapping: Attribute Statements, User Attributes & Claims
Steps
1
Create a SAML 2.0 application
Create a new SAML 2.0 application in your provider.
Display Name: The name shown to users during authentication.
Verified domain: The verified domain your login URL is based on. Lovable preselects it when you have only one.
Login URL suffix (optional): An addition to the login URL, for example engineering. Lovable shows the resulting URL below the field. See Your SSO login URL.
7
Finish SAML provider configuration in Lovable
In Lovable, click Configure SAML provider, review the confirmation page, then click Confirm & enable SSO to finish the configuration of your SAML SSO provider.
Set up IdP-initiated login (SAML)
With IdP-initiated SSO, users start login from your identity provider’s app portal (for example, an Okta dashboard tile or the Microsoft My Apps portal) instead of from Lovable. IdP-initiated login is optional and available for SAML providers on Business and Enterprise plans. It requires no additional configuration in Lovable. SP-initiated login from Lovable keeps working as long as your IdP app still accepts the standard ACS URL (https://auth.lovable.dev/__/auth/handler). If your provider has only one ACS URL field, use a dedicated app for IdP-initiated login so both flows keep working.
Requirements
A configured SAML SSO provider. OIDC providers support SP-initiated login only.
Your workspace is the only workspace that has verified your email domain. IdP-initiated login is disabled automatically while another workspace has the same domain verified.
Your IdP signs the SAML response (or the assertion within it) and scopes it to the Lovable SP Entity ID (https://auth.lovable.dev/__/auth/handler) through an Audience Restriction.
When a requirement is not met (for example, a second workspace verifies the same email domain), IdP-initiated login stops working and users see an error page such as Forbidden or Unauthorized. Login from Lovable is not affected, and you can switch back to SP-initiated login only at any time. See Troubleshooting.
Enable IdP-initiated login
Configure your SAML app (or a dedicated IdP-initiated app) to post the SAML response to the IdP-initiated ACS URL: https://api.lovable.dev/sso/saml/idp-consumeKeep the SP Entity ID / Audience URI unchanged: https://auth.lovable.dev/__/auth/handler.
Okta
Microsoft Entra ID
Auth0 and other providers
The Lovable app in the Okta App Catalog does not support IdP-initiated login yet. Its SAML settings are pre-configured and cannot be changed. For now, users logging in through Okta must start login from Lovable.
In your Lovable SAML enterprise application, go to Single sign-on → Basic SAML Configuration.
Add https://api.lovable.dev/sso/saml/idp-consume as an additional Reply URL (Assertion Consumer Service URL) and select it as the Default reply URL. Microsoft Entra sends IdP-initiated responses to the default reply URL.
Keep the Identifier (Entity ID) as https://auth.lovable.dev/__/auth/handler, and select Save.
Users can now log in to Lovable from the My Apps portal.
In your SAML application, set the ACS URL used for IdP-initiated login to https://api.lovable.dev/sso/saml/idp-consume. Providers also call this field Single sign-on URL, Reply URL, or Assertion Consumer Service URL. In Auth0, it is the Application Callback URL in the SAML2 Web App addon. The addon has a single callback URL, so create a dedicated Auth0 application for IdP-initiated login.
Keep the Audience / Entity ID as https://auth.lovable.dev/__/auth/handler.
Make sure your provider signs SAML responses or assertions.
IdP-initiated login is optional. If it does not work for your setup, point your SAML app back to https://auth.lovable.dev/__/auth/handler. This disables IdP-initiated login, and users log in from Lovable as usual. See Troubleshooting.
Map IdP groups to workspace roles
You can map the groups your identity provider sends in its login claims to Lovable workspace roles, so people receive the right role automatically, and optionally restrict SSO login to mapped groups only. Mappings can also add members to your workspace groups. See Add members to workspace groups automatically. Group mappings work with both OIDC and SAML providers on Business and Enterprise plans.To manage group mappings, go to Identity (Workspace settings → Access → Identity) and find Provisioning groups. There you can:
Map an IdP group to a workspace role. Click Add group. In Add provisioning group, enter the Group name exactly as your IdP sends it, then choose a Default role: Viewer, Editor, or Admin. Workspace owners can also select Owner. Click Add. Users whose login includes a matching group claim get that role when they join. Claims must match mappings exactly, including capitalization. If several mapped groups match, the highest-privilege role wins.
Enable Group restriction. While it is disabled, matched users get their group’s role and everyone else logs in with the provider’s Default role for new members (Editor if you haven’t changed it). While it is enabled, only users whose IdP group matches one of your mappings can join the workspace through the provider. Everyone else is denied. Add the groups that need access before you enable the restriction, because no one can join through a provider that has no provisioning groups.
Your IdP must include group information in its login claims for mappings to match. See Send group claims from your IdP.Role mapping and group membership sync also require SSO JIT (just-in-time provisioning) to be enabled. With JIT disabled, matched users log in without receiving a mapped role or group membership. Group restriction applies either way.
Add members to workspace groups automatically
Group mappings also provision group membership. When a user logs in through SSO with a group claim that matches a mapping, Lovable adds the user to the workspace group with the same name as that mapping.
Groups are matched by name. To add members to an existing Lovable group, enter its exact name in Group name, including capitalization.
Lovable creates the group if it does not exist. The first matching login creates a workspace group named after the mapping and adds the user to it. Groups control access to projects, folders, and published apps, so review what a new group can access in Groups (Workspace settings → Access → Groups). Unmapped group claims never create groups.
SCIM-managed groups are the exception. If your workspace groups come from SCIM provisioning, Lovable does not create groups from login claims.
Membership is only added, never removed. Lovable does not remove anyone from a group based on login claims. Remove members from groups yourself if needed. To manage the full group lifecycle from your IdP, including removals, use SCIM provisioning on the Enterprise plan.
Send group claims from your IdP
Lovable reads groups from a claim named groups in the login response, for both OIDC and SAML providers. The default SAML group claim names used by Microsoft Entra ID (http://schemas.microsoft.com/ws/2008/06/identity/claims/groups) and AD FS (http://schemas.xmlsoap.org/claims/Group) are also recognized, so you can keep those defaults.The claim must contain group names, not group IDs. Send names as multiple attribute values, or as a single value separated by commas or semicolons.
Okta
Microsoft Entra ID
Other providers
Configure the group claim on your Lovable app in the Okta Admin Console.SAMLWhere the group attribute is configured depends on how you added the Lovable app:
App Catalog app: the app’s SAML settings are pre-configured and cannot be edited. Open the app’s Sign On tab and look for a Group Attribute Statements section there. If the app doesn’t offer one, it cannot send group claims: use the Lovable OIDC app instead, or create a custom SAML app following Configure other providers.
Custom SAML app: open the app’s General tab and click Edit under SAML Settings.
Add a group attribute statement with:
Name: groups
Name format: Unspecified
Filter: a filter matching the groups to send, for example Matches regex.* to send all of the user’s groups.
Save your changes.OIDC
Open your Lovable OIDC app and go to the Sign On tab.
Under OpenID Connect ID Token, click Edit and set Groups claim type to Filter.
Set the groups claim name to groups with a filter matching the groups to send, for example Matches regex.*.
Save your changes.
Okta sends group names in the claim, so values match your mappings as long as the names line up.
In your Lovable enterprise application, go to Single sign-on → Attributes & Claims → Edit.
Click Add a group claim.
Choose which groups to include. Groups assigned to the application is recommended: it sends only the groups assigned to the Lovable app and avoids token size limits.
Set Source attribute to an option that emits group names, such as Cloud-only group display names, or sAMAccountName for groups synced from on-premises Active Directory.
Save the claim. You can keep the default claim name: Lovable recognizes Microsoft Entra’s default group claim.
By default, Microsoft Entra ID sends group object IDs (GUIDs) instead of names. Object IDs never match name-based mappings, so make sure the claim’s source attribute emits group names.
In your SAML or OIDC application, include a group attribute or claim named groups in the login response.
Make sure the values are group names (not IDs) and cover the groups you mapped in Lovable.
Manage an existing SSO provider
Workspace owners and admins can change a provider’s settings without deleting it. Go to Identity (Workspace settings → Access → Identity) and click the provider in the SSO providers section. The provider dialog includes these tabs:
General: the Display name, the Login URL suffix, and the Default role for new members.
Connection: the settings Lovable uses to verify sign-ins from your identity provider. For SAML, the Identity provider entity ID, the Sign-on URL, and the Signing certificates. For OIDC, the Client ID, the Issuer, and a new Client secret with its expiration date. A new entity ID, client ID, or issuer moves the provider to a different identity provider. See Move to a new identity provider.
Enterprise-managed authentication: enable, update, or disable access to Lovable from Claude through this provider. See Set up enterprise-managed authentication.
Manage group mappings and Group restriction under Provisioning groups on the Identity page. See Map IdP groups to workspace roles.Your changes take effect when you click Save changes. Before Lovable saves a change on the Connection tab, it checks the values. For SAML, Lovable validates the sign-on URL and reads every certificate. For OIDC, Lovable contacts your provider to check the new client secret. If a check fails, Lovable shows the error and keeps the current configuration. If Lovable cannot reach your provider, or your provider does not support checking a secret in advance, Lovable saves the new secret and shows a warning that it could not check the secret. Your provider then checks the secret at the next login. Each saved connection change appears in the audit log as SSO connection updated.
Move to a new identity provider
When your workspace moves to a different identity provider, edit the existing SSO provider instead of deleting it. Editing keeps the settings that deleting disables, such as Enforce SSO, SCIM provisioning, and the domain lock.Members keep their accounts, but each account stays linked to the old identity provider. A member cannot log in through the new provider until that link is removed.Members with another login method can unlink the old provider in Account settings → Account → Login methods. For members who log in only with SSO, contact Lovable support to remove the link.Before you move the provider, delete its IdP group role mappings and disable enterprise-managed authentication for it. Both were set up for the old identity provider, so Lovable shows an error and does not save the move while either is still in place.To move the provider, click it in the SSO providers section of Identity (Workspace settings → Access → Identity). On the Connection tab, enter the new provider’s details:
SAML: the new Identity provider entity ID, and the new provider’s signing certificate under Add a certificate. When you save, Lovable removes the current certificates and no longer accepts sign-ins signed by the old provider.
OIDC: the new Client ID, the new Issuer, or both, and the new provider’s Client secret.
When you save, Lovable asks you to confirm the change.You cannot change a provider between SAML and OIDC. A workspace has one SSO provider, so to change the protocol, delete the provider and set up a new one. See Delete an SSO provider.
Rotate a SAML signing certificate
You can add up to 10 signing certificates to a SAML provider, and Lovable accepts sign-ins signed with any of them. When your identity provider issues a new signing certificate, paste it under Add a certificate on the Connection tab before your provider starts using it, so login continues without interruption. Remove the old certificate with its delete icon after the switch. Each certificate shows its subject, fingerprint, and expiration date. Lovable warns when a certificate expires within 30 days and does not save a change that leaves only expired certificates.During setup, Test & import from your metadata URL adds the signing certificates listed in your metadata.
Track the OIDC client secret expiration
Your identity provider does not share the expiration date of an OIDC client secret with Lovable, so you record it yourself. During setup, choose 3 months, 6 months, 12 months, Custom, or No expiration under Client secret expiration (optional). When you enter a new client secret on the Connection tab, choose from the same options under New secret expiration (optional).A badge next to the client secret on the Connection tab shows its status:
Valid until and the date, while more than 30 days remain.
Expires in and the number of days, during the last 30 days.
Expires today, on the expiration date.
Expired and the date, after the expiration date has passed.
Lovable does not send a notification before a secret expires. Check the badge when you plan to create a new secret. When you enter a new secret without a date, Lovable clears the stored expiration date.
Delete an SSO provider
To change a provider’s sign-on URL, certificates, client secret, or identity provider, edit it instead of deleting it. See Manage an existing SSO provider.To remove your workspace SSO provider, go to Identity (Workspace settings → Access → Identity), find the provider in the SSO providers section, and click its delete icon.Because a workspace can have only one SSO provider, deleting it turns off SSO for the workspace. Lovable shows a Delete SSO provider confirmation dialog that lists what else it disables, based on your workspace’s current configuration:
Turn off Enforce SSO: members can use the workspace again without an SSO session.
Remove SCIM provisioning: the SCIM API key is revoked and SCIM-managed groups are deleted. Existing workspace members are not removed. See Set up SCIM user provisioning.
Disable this workspace’s domain lock: people with emails on your verified domains can create their own workspaces again, unless another workspace still locks the domain.
Delete n IdP group role mappings, where n is your number of mappings: IdP groups no longer grant workspace roles on login.
The dialog lists each of these only when it applies to your workspace. Click Delete provider to confirm.
Deleting a provider cannot be undone. To use SSO again, you need to configure the provider again from the beginning. Lovable does not keep the previous configuration.
Members keep their workspace access after the provider is deleted. Members whose only login method was that provider can recover their account themselves at the next login. See Recover access after an SSO provider is removed.Each side effect is recorded in the audit log: both the SSO provider removed entry (with the exact settings that were turned off) and, when SCIM was configured, a separate SCIM disabled entry.
Troubleshooting
OIDC
SAML
Invalid or mismatched Redirect URI
Ensure the redirect/callback URL exactly matches https://auth.lovable.dev/__/auth/handler in your IdP.
Issuer URL / discovery fails
Use the provider’s OIDC Issuer URL, not only the domain.
For Okta, copy from the Sign-on tab
For Auth0, use your tenant domain.
Email not returned
Grant the email scope and ensure the user account has a primary email.
Authorization flow issues
Use Authorization Code with a confidential client and client secret. Avoid implicit or PKCE-only app types.
Login stops working after the client secret expires
Create a new client secret in your identity provider, then enter it on the provider’s Connection tab in Lovable and record its expiration date. See Track the OIDC client secret expiration.
Invalid ACS or Audience
Ensure both ACS and Audience/Entity ID exactly match https://auth.lovable.dev/__/auth/handler in your IdP.
Email claim missing
Make sure to map an email claim.For Microsoft Entra ID, map email to user.mail. If user.mail is empty, use user.userprincipalname.
Provider credentials invalid
Paste the correct X.509 certificate. If your identity provider rotates its certificate, add the new one on the provider’s Connection tab. See Rotate a SAML signing certificate.
Group mappings don't match
If users get the default role instead of their mapped role, or Group restriction denies people it shouldn’t:
Make sure the assertion includes a group attribute named groups (Microsoft Entra ID’s and AD FS’s default group claim names also work). See Send group claims from your IdP.
Make sure the claim contains group names, not IDs. Microsoft Entra ID sends object IDs unless the group claim’s source attribute is set to emit names.
Claim matching is case-sensitive, so the value your IdP sends must match your mapping exactly, including capitalization.
Make sure SSO JIT is enabled. With it disabled, users log in without receiving mapped roles or group memberships.
IdP-initiated login fails or shows an error page
If starting login from your IdP’s app portal shows an error page (for example, Forbidden or Unauthorized):
Make sure your email domain is verified in only one Lovable workspace. IdP-initiated login is disabled automatically while more than one workspace has verified the same domain.
Make sure your IdP signs the SAML response (or the assertion within it) and the Audience Restriction matches https://auth.lovable.dev/__/auth/handler.
If your provider restricts access by group, make sure the user’s SAML assertion includes a matching group claim. This also applies when logging in from Lovable.
If login still fails, change the ACS URL in your IdP app back to https://auth.lovable.dev/__/auth/handler. This disables IdP-initiated login and restores SP-initiated login from Lovable. IdP-initiated login is optional, so you can stay on SP-initiated login only and try again when the requirements are met.
Recover access after an SSO provider is removed
Workspace members who only ever logged in through the deleted SSO provider can recover access themselves from the standard Lovable login page, with no admin action or support request required. When they enter their email on the login page, Lovable detects that their only login method was the removed provider and shows a recovery panel:
If the workspace has a replacement SSO provider on the same verified domain, the panel shows Reconnect your account with a login button for the new provider. Clicking it logs the user in with that provider and links the new identity to their existing account, so their projects, roles, and history are preserved. If linking cannot happen automatically (for example, the new provider does not verify the same email), the panel falls back to the password path below.
If there is no replacement SSO provider, the panel shows Set a password for your account and offers to email a link. The user opens the link, sets a password, and logs in with email and password from then on.
Users with any other working login method (password, Google, GitHub, Apple, or another still-valid SSO provider) are not affected and continue to log in normally.
FAQ
I already have an account, but I'm joining a business workspace that uses SSO. How do I log in?
If you created your account using another login method (such as email and password, Google, or GitHub), you need to log in that way first. When you’re logged in, go to Account settings → Account → Login methods and click Link account under Link company account, then log in with your company SSO. This links your existing account to your company SSO.
Important: If you attempt to log in with SSO before linking your existing account, you’ll see an error. This is a security measure to prevent unauthorized access. Log in using your original method first to complete the linking process.
Can members who log in with SSO use 'Forgot password?' on the login page?
No. Forgot password? only works for accounts that have an email and password login method.If your account logs in through Google, GitHub, Apple, or a SAML/OIDC SSO provider, Lovable does not send a password reset email and shows a Password reset unavailable message, because completing a reset would add a password to an account that is meant to log in through your provider. Reset your credentials with your identity provider instead (for example, Google Account recovery or your company IdP).
Exception for deleted SSO providers: if your only login method was an SSO provider that has since been removed from your workspace, you can set a password for the first time through the recovery flow on the login page. See Recover access after an SSO provider is removed.
Which SSO providers does Lovable support?
Lovable supports the industry-standard OIDC and SAML protocols, so you can integrate with any SSO provider that supports them.
Does Lovable support multiple SSO providers per workspace?
No. A workspace can have one active SSO provider configured at a time.
Can I enforce SSO for my workspace?
Yes. The workspace owner or admin can enable Enforce SSO in Identity (Workspace settings → Access → Identity) and choose the Session duration that sets how long users stay logged in before Lovable requires a new SSO login, from 8 hours to 30 days, or Indefinite for no time limit.All workspace members must then log in through SSO. If your SSO provider is Google, a member who logs in with a Google Workspace account on your verified domain already has an SSO session and is not asked to log in again. When you enable it, Lovable asks whether to remove external collaborators from your projects. Invite links keep working only for people whose email is on one of your verified domains. See Enforce SSO.Test an SSO login first. For six hours after you add a provider, the Enforce SSO toggle stays disabled and shows Wait 6 hours and test SSO login before enforcing SSO.
Does Lovable support IdP-initiated SSO?
Yes. SAML providers can optionally enable IdP-initiated login: users start login from your IdP’s app portal once your SAML app posts the SAML response to https://api.lovable.dev/sso/saml/idp-consume. It only works while your workspace is the only workspace that has verified your email domain, and SP-initiated login from Lovable keeps working either way. See Set up IdP-initiated login (SAML).OIDC providers support SP-initiated login only: users must start login from Lovable.
What should I do if IdP-initiated login shows an error?
An error page such as Forbidden or Unauthorized means the requirements are not met. First, make sure your email domain is verified in only one Lovable workspace. IdP-initiated login is disabled automatically while more than one workspace has verified the same domain.If login still fails, change the ACS URL in your IdP app back to https://auth.lovable.dev/__/auth/handler. IdP-initiated login is optional: users log in from Lovable as usual, and you can try again when the requirements are met.
Does Lovable support just-in-time (JIT) provisioning with SSO?
Yes, Lovable supports JIT (just-in-time) provisioning through SSO. User accounts are created automatically the first time someone logs in via SSO, and they’re added to your company workspace.You can also set the provider’s Default role for new members (Viewer, Editor, or Admin), which applies when users join via SSO for the first time. If you don’t change it, JIT-created users join as an Editor.On Enterprise plans, workspace owners and admins can enable or disable SSO JIT in Identity (Workspace settings → Access → Identity → User provisioning). The toggle appears once an SSO provider is configured.On Business plans, SSO JIT is automatically enabled when an SSO provider is configured, and the row shows a read-only Enabled or Disabled status. Contact Lovable support if you need it changed. See Manage workspace identity and user provisioning for how the provisioning options work together.
What happens to existing members when I set up group mappings?
Existing members keep their current role. Lovable applies group-to-role mappings when someone joins the workspace through SSO. If several mapped groups match, the highest-privilege role wins.On each SSO login, members are also added to any workspace groups whose names match their IdP group claims. Lovable never removes anyone from a group automatically. Remove members from groups yourself if needed.Enabling Group restriction affects existing members: anyone logging in through the provider without a matching group claim is denied, so make sure your mappings cover everyone who should keep access. See Map IdP groups to workspace roles.
Does Lovable create workspace groups from IdP group claims?
Yes, for mapped groups. When a login matches a mapping and your workspace has no group with that name, Lovable creates the group and adds the user to it. Unmapped group claims never create groups, and Lovable does not create groups from login claims when your workspace groups come from SCIM provisioning. See Add members to workspace groups automatically.
Does Lovable support SCIM or automatic user provisioning?
Yes. Lovable supports SCIM provisioning for automated user provisioning and deprovisioning on the Enterprise plan.With SCIM, user creation, removal, and role assignment are managed centrally from your identity provider based on assignments and group membership.See Set up SCIM user provisioning for more information.
How can I find my tenant ID (SSO login identifier)?
Your tenant ID is the {tenantId} value in your SSO login URL, https://lovable.dev/sso-login/{tenantId}. It is your verified domain with dots replaced by hyphens, plus the optional Login URL suffix you entered during setup.After setup, the full URL appears in the SSO providers row in Identity (Workspace settings → Access → Identity) and in the provider’s Login URL field. See Your SSO login URL.
How can I edit my SSO provider configuration?
Click the provider in Identity (Workspace settings → Access → Identity) to open its settings. On the General tab you can change the Display name, the Login URL suffix, and the Default role for new members, then click Save changes. The Connection tab lets you change the SAML sign-on URL and signing certificates, or enter a new OIDC client secret and its expiration date. Manage group mappings and Group restriction under Provisioning groups on the Identity page.Use the Enterprise-managed authentication tab to manage access from Claude.To move to a new identity provider, change the entity ID, issuer, or client ID on the Connection tab. See Move to a new identity provider.
Deleting the provider also turns off Enforce SSO, removes SCIM provisioning (revoking the SCIM API key and deleting SCIM-managed groups), disables the verified-domain lock, and deletes any IdP group role mappings. The delete dialog lists exactly which of these apply before you confirm. See Delete an SSO provider.
What happens to users who only logged in via SSO if we delete the provider?
They keep their workspace access and can recover their account themselves from the login page: either by logging in through a replacement SSO provider (Lovable links the new identity to their existing account) or by setting a password through an emailed link. See Recover access after an SSO provider is removed.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Lovable Documentation","description":"Lovable Documentation — Build full-stack websites with AI using natural language. Explore Lovable features, integrations, tutorials, and best practices.","colors":{"primary":"#0095FF","light":"#1AA3FF","dark":"#0084E6"},"logo":{"light":"https://mintcdn.com/lovable-f9060f1e/lZT1ihBcprll2Agr/assets/logo/logoblack.svg?fit=max\u0026auto=format\u0026n=lZT1ihBcprll2Agr\u0026q=85\u0026s=8d9eafaf19f94e27f0d13ac160d54f54","dark":"https://mintcdn.com/lovable-f9060f1e/lZT1ihBcprll2Agr/assets/logo/logowhite.svg?fit=max\u0026auto=format\u0026n=lZT1ihBcprll2Agr\u0026q=85\u0026s=fed1a7a9be6502f49d06a55cec77288c","href":"https://lovable.dev/"},"favicon":"https://mintcdn.com/lovable-f9060f1e/b_1_IEcMDh-0NUDG/assets/logo/favicon.svg?fit=max\u0026auto=format\u0026n=b_1_IEcMDh-0NUDG\u0026q=85\u0026s=a439abba3defb47beabd3f6e7d318cb5","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl"],"prefill":true,"autogenerate":true},"url":"full"},"navbar":{"links":[{"icon":"message","href":"https://lovable.dev/support","label":"Support"},{"icon":"blog","href":"https://lovable.dev/blog","label":"Blog"}],"primary":{"type":"button","label":"Start building for free","href":"https://lovable.dev/signup?utm_source=lovable_docs\u0026utm_medium=navigation"}},"footer":{"socials":{"x":"https://x.com/Lovable","github":"https://github.com/lovablelabs","linkedin":"https://linkedin.com/company/lovable-dev","youtube":"https://youtube.com/@lovable","discord":"https://discord.gg/lovable-dev","reddit":"https://www.reddit.com/r/lovable"}},"seo":{"metatags":{"og:image":"/assets/logo/opengraph-image.png","canonical":"https://docs.lovable.dev"},"indexing":"all"},"contextual":{"options":["copy","assistant","download-pdf","download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lovable-f9060f1e","hasAudioNarration":false,"actualSubdomain":"lovable-f9060f1e","customDomains":["docs.lovable.dev"],"gitSource":{"type":"github","owner":"lovablelabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0229b2890505f6de0e069c","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":318},{"language":"default","tag":"Connect","count":151},{"language":"default","tag":"Connector catalog","count":136},{"language":"default","tag":"Build","count":76},{"language":"default","tag":"Workspace \u0026 account","count":35},{"language":"default","tag":"API Reference","count":34},{"language":"default","tag":"Lovable API","count":28},{"language":"default","tag":"Endpoints","count":26},{"language":"default","tag":"Backend","count":22},{"language":"default","tag":"Data \u0026 databases","count":21}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"link","email":"support@lovable.dev","url":"https://lovable.dev/support"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instinct-self-updating-docs","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false,"authValue":{"userAuth":{"type":"shared-session","apiUrl":"https://lovable.dev/api/docs/user"}}},"customCss":[{"filePath":"assets/css/styles.css","content":".supabase{color:#59cf8c}"}]}
{"page":{"pagePath":"features/business/sso","slug":"/features/business/sso","pageMetadata":{"title":"Set up workspace single sign-on (SSO)","sidebarTitle":"Workspace SSO","description":"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.","keywords":["single sign-on","sso","SSO setup","SSO configuration","SSO integration","enterprise SSO","enforce SSO","identity provider","OIDC","SAML","Okta SSO","Auth0 SSO","Microsoft Entra ID SSO","Azure AD SSO","Google Workspace SSO","logging in twice","SSO group mapping","group claims","group-based provisioning","group restriction","IdP groups","IdP-initiated SSO","IdP-initiated SAML"],"href":"/features/business/sso"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Info,Note,Step,Steps,Tab,Tabs,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[_jsxs(_components.p,{children:[`This page documents `,_jsx(_components.strong,{children:`workspace-level SSO for your team’s access to Lovable itself`}),`. It is configured at the workspace level under `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`).`]}),_jsxs(_components.p,{children:[`Looking for SAML SSO for the `,_jsx(_components.strong,{children:`end users of your app`}),`? See `,_jsx(_components.a,{href:`/features/saml-sso`,children:`Add SAML single sign-on to your app`}),`. Want apps you build to `,_jsx(_components.strong,{children:`recognize logged-in workspace members without a login page`}),`? See `,_jsx(_components.a,{href:`/features/lovable-workspace-identity-reuse`,children:`Reuse Lovable workspace identity in your app`}),`. Both are different features.`]})]}),`\n`,_jsxs(_components.p,{children:[`Single sign-on (SSO) is available on `,_jsx(_components.strong,{children:`Business`}),` and `,_jsx(_components.strong,{children:`Enterprise`}),` plans and enables secure, centralized authentication across your company. With SSO, users can access Lovable with one set of credentials, simplifying access management and improving security.`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Service provider (SP)-initiated login`}),` is supported for all providers: users start login from Lovable.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Identity provider (IdP)-initiated SSO`}),` (starting from an IdP dashboard tile) can optionally be enabled for `,_jsx(_components.strong,{children:`SAML`}),` providers. See `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`Set up IdP-initiated login (SAML)`}),`. OIDC providers support SP-initiated login only.`]})]}),`\n`,_jsxs(_components.p,{children:[`To let members use Lovable from Claude through this SSO provider, see `,_jsx(_components.a,{href:`/features/enterprise-managed-auth`,children:`Set up enterprise-managed authentication`}),`. Claude supports this flow with `,_jsx(_components.strong,{children:`Okta only`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If your workspace belongs to an `,_jsx(_components.a,{href:`/features/organizations`,children:`organization`}),`, an org admin can set up SSO once for every workspace. See `,_jsx(_components.a,{href:`/features/organization-identity#set-up-sso-for-the-organization`,children:`Set up SSO for the organization`}),`. If the workspace is `,_jsx(_components.strong,{children:`Managed by the organization`}),`, its `,_jsx(_components.strong,{children:`Identity`}),` tab shows that the organization manages these settings.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-sso-protocols`,children:`Supported SSO protocols`}),`\n`,_jsxs(_components.p,{children:[`Lovable supports both `,_jsx(_components.strong,{children:`OIDC`}),` and `,_jsx(_components.strong,{children:`SAML 2.0`}),` protocols, enabling integration with all major `,_jsx(_components.strong,{children:`identity providers (IdP)`}),` including Okta, Auth0, Microsoft Entra ID (Azure AD), and more.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OpenID Connect (OIDC)`}),`: recommended. A modern identity layer built on OAuth 2.0 that verifies who is logging in.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SAML (Security Assertion Markup Language) 2.0`}),`: XML-based protocol for exchanging authentication and authorization data, widely used in enterprise environments.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:`To connect your identity provider to Lovable using OIDC or SAML, you need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Admin access to your identity provider`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Workspace owner or admin role`}),` in Lovable`]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.strong,{children:`verified domain`}),` in Lovable, to prove domain ownership`,`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`To verify your domain, add the `,_jsx(_components.code,{children:`TXT`}),` record displayed in the UI to your DNS provider. See `,_jsx(_components.a,{href:`/features/verified-domains`,children:`Verify a domain for your workspace`}),` for the full walkthrough, including record details and troubleshooting.`]})}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`start-sso-setup-in-lovable`,children:`Start SSO setup in Lovable`}),`\n`,_jsxs(_components.p,{children:[`SSO configuration is a `,_jsx(_components.strong,{children:`two-way setup`}),` between Lovable and your identity provider:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Lovable → IdP:`}),` copy Lovable URLs and settings into your IdP app.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP → Lovable:`}),` copy your IdP’s issuer, metadata, and certificates back into Lovable.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The workspace `,_jsx(_components.strong,{children:`owner`}),` or `,_jsx(_components.strong,{children:`admin`}),` can set up SSO. To start, go to `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) and click `,_jsx(_components.strong,{children:`Add provider`}),` in the `,_jsx(_components.strong,{children:`SSO providers`}),` section. On the `,_jsx(_components.strong,{children:`Choose SSO Protocol`}),` screen, click `,_jsx(_components.strong,{children:`Configure OIDC`}),` or `,_jsx(_components.strong,{children:`Configure SAML`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Add provider`}),` stays disabled until your workspace has a verified domain and shows `,_jsx(_components.strong,{children:`Add a verified domain first`}),`. Add one in the `,_jsx(_components.strong,{children:`Verified domains`}),` section, then start SSO setup.`]})}),`\n`,_jsx(_components.p,{children:`The setup then runs in three stages:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Preparation.`}),` Lovable shows what to configure in your IdP, such as the app type, scopes, and attribute mappings, and the Lovable URLs to copy into your IdP. The values are listed in the reference below.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Configuration.`}),` You enter your IdP’s issuer and client credentials or certificates, a display name, and the verified domain your login URL is based on. The provider guides below list the exact fields.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test and confirm.`}),` For OIDC, `,_jsx(_components.strong,{children:`Test configuration`}),` checks your values before you continue. Both protocols end on a confirmation page where you click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`idp-configuration-reference`,children:`IdP configuration reference`}),`\n`,_jsx(_components.p,{children:`Use these values while configuring OIDC or SAML in your IdP. Lovable shows the same values on the preparation screens, with copy buttons on the URLs.`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OIDC`,id:`oidc`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Application type: `,_jsx(_components.code,{children:`Web Application`}),` or `,_jsx(_components.code,{children:`Server-side Application`})]}),`\n`,_jsxs(_components.li,{children:[`Grant type: `,_jsx(_components.code,{children:`Authorization Code`})]}),`\n`,_jsxs(_components.li,{children:[`Token method: `,_jsx(_components.code,{children:`POST`}),` (if configurable)`]}),`\n`,_jsxs(_components.li,{children:[`Redirect URI to copy and add to your IdP: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`OAuth scopes:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Required: `,_jsx(_components.code,{children:`openid`}),`, `,_jsx(_components.code,{children:`email`})]}),`\n`,_jsxs(_components.li,{children:[`Recommended: `,_jsx(_components.code,{children:`profile`})]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Optional claims: `,_jsx(_components.code,{children:`department`}),`, `,_jsx(_components.code,{children:`title`}),`, `,_jsx(_components.code,{children:`division`}),`, `,_jsx(_components.code,{children:`manager`}),`, for the member’s department, job title, division, and manager’s display name. Lovable also accepts `,_jsx(_components.code,{children:`departmentName`}),`, `,_jsx(_components.code,{children:`jobTitle`}),`, `,_jsx(_components.code,{children:`managerDisplayName`}),`, and `,_jsx(_components.code,{children:`managerName`}),`. Claim names are case-sensitive. Lovable shows the department in `,_jsx(_components.a,{href:`/features/insights#adoption-by-department`,children:`Insights`}),`.`]}),`\n`]})}),_jsx(Tab,{title:`SAML`,id:`saml`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`ACS URL (Assertion Consumer Service): `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`SP Entity ID / Audience URI: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`IdP-initiated ACS URL (optional, see `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`Set up IdP-initiated login (SAML)`}),`): `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`})]}),`\n`,_jsxs(_components.li,{children:[`Attribute mappings:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`displayName`}),` (recommended): map to user’s full name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`photoURL`}),` (recommended): map to user’s profile picture URL`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`department`}),`, `,_jsx(_components.code,{children:`title`}),`, `,_jsx(_components.code,{children:`division`}),`, `,_jsx(_components.code,{children:`manager`}),` (optional): map to the member’s department, job title, division, and manager’s display name. Lovable also accepts `,_jsx(_components.code,{children:`departmentName`}),`, `,_jsx(_components.code,{children:`jobTitle`}),`, `,_jsx(_components.code,{children:`managerDisplayName`}),`, and `,_jsx(_components.code,{children:`managerName`}),`. Attribute names are case-sensitive. Lovable shows the department in `,_jsx(_components.a,{href:`/features/insights#adoption-by-department`,children:`Insights`}),`.`]}),`\n`,_jsx(_components.li,{children:`Email is not a separate attribute. Lovable reads it from the Name ID, so the Name ID source must be the user’s email address, not a login identifier.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Protocol settings:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Name ID format: `,_jsx(_components.code,{children:`EmailAddress`})]}),`\n`,_jsxs(_components.li,{children:[`Signature algorithm: `,_jsx(_components.code,{children:`RSA-SHA256`})]}),`\n`,_jsxs(_components.li,{children:[`SAML binding: `,_jsx(_components.code,{children:`HTTP-POST`})]}),`\n`,_jsx(_components.li,{children:`Response signed: yes`}),`\n`]}),`\n`]}),`\n`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`your-sso-login-url`,children:`Your SSO login URL`}),`\n`,_jsxs(_components.p,{children:[`Each provider gets a login URL that members can use to log in with SSO directly: `,_jsx(_components.code,{children:`https://lovable.dev/sso-login/{tenantId}`}),`. The `,_jsx(_components.code,{children:`{tenantId}`}),` part is your verified domain with dots replaced by hyphens, for example `,_jsx(_components.code,{children:`acme-com`}),` for `,_jsx(_components.code,{children:`acme.com`}),`. If you enter a `,_jsx(_components.strong,{children:`Login URL suffix`}),` during setup, Lovable appends it, for example `,_jsx(_components.code,{children:`acme-com-engineering`}),`. Login identifiers are unique across Lovable, so a second workspace on the same domain needs a suffix. After setup, the URL appears in the `,_jsx(_components.strong,{children:`SSO providers`}),` row and in the provider’s `,_jsx(_components.strong,{children:`Login URL`}),` field, each with a copy button.`]}),`\n`,_jsx(Heading,{level:`3`,id:`enforce-sso`,children:`Enforce SSO`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Enforce SSO`}),` requires an active SSO session to use the workspace. Members who log in another way are asked to log in through your provider before they can access it. The toggle in `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) becomes available when your workspace has a verified domain and an SSO provider. Test an SSO login before you enable it: for six hours after you add a provider, the toggle stays disabled and shows `,_jsx(_components.strong,{children:`Wait 6 hours and test SSO login before enforcing SSO`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If your SSO provider is Google, members log in once. A member who selects `,_jsx(_components.strong,{children:`Continue with Google`}),` and uses a Google Workspace account on your verified domain gets an SSO session from that login, so Lovable does not ask them to log in again.`]}),`\n`,_jsx(_components.p,{children:`A member still needs a separate SSO login when:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The member logs in with a personal Google account instead of one your Google Workspace manages.`}),`\n`,_jsx(_components.li,{children:`Your SSO provider is not Google. Google SAML and Google OIDC both count, and other providers such as Okta, Auth0, and Microsoft Entra ID do not.`}),`\n`,_jsxs(_components.li,{children:[`Your provider uses `,_jsx(_components.a,{href:`#map-idp-groups-to-workspace-roles`,children:`Group restriction`}),`, because a Google login sends no group claims.`]}),`\n`,_jsx(_components.li,{children:`Another workspace on your verified domain also uses a Google SSO provider.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`These logins appear in your `,_jsx(_components.a,{href:`/features/audit-logs`,children:`audit logs`}),` as SSO workspace access, so you keep the same record of who logged in.`]}),`\n`,_jsxs(_components.p,{children:[`When you enable the toggle, Lovable opens the `,_jsx(_components.strong,{children:`Enable enforce SSO`}),` dialog:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Keep `,_jsx(_components.strong,{children:`Remove all external collaborators`}),` selected and click `,_jsx(_components.strong,{children:`Enable and remove`}),` to remove external collaborators from every project in the workspace.`]}),`\n`,_jsxs(_components.li,{children:[`Clear it and click `,_jsx(_components.strong,{children:`Enable`}),` to keep them. Lovable then sets the external collaborator level to allow all collaborators. You can change it later in `,_jsx(_components.a,{href:`https://lovable.dev/settings/privacy-security`,children:_jsx(_components.strong,{children:`Workspace settings → Security → Privacy \u0026 security`})}),`. See `,_jsx(_components.a,{href:`/features/privacy-and-security-settings`,children:`Privacy and security settings`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`While SSO is enforced, invite links only work for people whose email is on one of your verified domains.`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Session duration`}),` to choose how long members stay logged in before Lovable requires a new SSO login:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`8 hours`}),`, `,_jsx(_components.strong,{children:`24 hours`}),`, `,_jsx(_components.strong,{children:`48 hours`}),`, `,_jsx(_components.strong,{children:`7 days`}),`, or `,_jsx(_components.strong,{children:`30 days`}),`: members log in through SSO again when that time has passed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Indefinite`}),`: the SSO login has no time limit, so Lovable does not ask members to log in through SSO again. A workspace uses `,_jsx(_components.strong,{children:`Indefinite`}),` until you choose a length.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`You cannot enable `,_jsx(_components.strong,{children:`Enforce SSO`}),` while `,_jsx(_components.a,{href:`/features/privacy-and-security-settings#require-two-factor-authentication`,children:`Require two-factor authentication`}),` is set to `,_jsx(_components.strong,{children:`Everyone`}),`. Set it to `,_jsx(_components.strong,{children:`External collaborators`}),` to keep requiring 2FA from external collaborators, or to `,_jsx(_components.strong,{children:`Off`}),` to drop the requirement. Under enforced SSO, Lovable does not ask members for a second factor, so require one in your identity provider.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`provider-specific-setup-guides`,children:`Provider-specific setup guides`}),`\n`,_jsxs(_components.p,{children:[`If you use Okta, Auth0, or Microsoft Entra, you can find provider-specific documentation for setting up SSO. If you use another provider, see `,_jsx(_components.a,{href:`#configure-other-providers`,children:`Configure other providers`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Before you begin, complete `,_jsx(_components.a,{href:`#start-sso-setup-in-lovable`,children:`Start SSO setup in Lovable`}),` to get the settings and values you need to use in your IdP.`]}),`\n`,_jsx(_components.p,{children:`For more information, refer to your IdP’s official documentation.`}),`\n`,_jsx(Heading,{level:`3`,id:`configure-okta-as-your-sso-provider`,children:`Configure Okta as your SSO provider`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OIDC`,id:`oidc-2`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Add the Lovable app in Okta`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Okta Admin Console`}),`, go to `,_jsx(_components.strong,{children:`Applications → Browse App Catalog`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Search for `,_jsx(_components.strong,{children:`Lovable`}),`, then click `,_jsx(_components.strong,{children:`Add Integration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`General Settings`}),` screen, set the `,_jsx(_components.strong,{children:`Application label`}),` (for example, `,_jsx(_components.code,{children:`Lovable OIDC`}),`), then click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`Sign-On Options`}),` screen, select `,_jsx(_components.strong,{children:`OpenID Connect`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.strong,{children:`Application username format`}),` to `,_jsx(_components.strong,{children:`Email`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Done`}),`.`]}),`\n`]})}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsxs(_components.p,{children:[`In Okta, copy the following values from the `,_jsx(_components.strong,{children:`Sign On`}),` tab and enter them in Lovable.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`Issuer URL`}),` → Lovable `,_jsx(_components.code,{children:`OIDC Issuer URL / Discovery Endpoint`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`To find your issuer, click the `,_jsx(_components.strong,{children:`OpenID Provider Metadata`}),` link on the `,_jsx(_components.strong,{children:`Sign On`}),` tab. The issuer is your Okta domain, for example `,_jsx(_components.code,{children:`https://your-org.okta.com`}),`.`]})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`Client ID`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client ID / Application ID`})]}),`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`Client Secret`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client Secret`})]}),`\n`,_jsxs(_components.li,{children:[`Optionally, the date the client secret expires → Lovable `,_jsx(_components.code,{children:`Client secret expiration (optional)`})]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Test the configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Test configuration`}),`. Lovable checks the issuer, client ID, and client secret and shows the outcome on the `,_jsx(_components.strong,{children:`Test results`}),` screen. Fix anything it reports, then click `,_jsx(_components.strong,{children:`Configure provider`}),`.`]})}),_jsx(Step,{title:`Finish OIDC provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Okta as your OIDC SSO provider.`]})})]})}),_jsx(Tab,{title:`SAML`,id:`saml-2`,children:_jsxs(Steps,{children:[_jsxs(Step,{title:`Add the Lovable app in Okta`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Okta Admin Console`}),`, go to `,_jsx(_components.strong,{children:`Applications → Browse App Catalog`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Search for `,_jsx(_components.strong,{children:`Lovable`}),`, then click `,_jsx(_components.strong,{children:`Add Integration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`General Settings`}),` screen, set the `,_jsx(_components.strong,{children:`Application label`}),` (for example, `,_jsx(_components.code,{children:`Lovable SAML`}),`), then click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`Sign-On Options`}),` screen, select `,_jsx(_components.strong,{children:`SAML 2.0`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.strong,{children:`Application username format`}),` to `,_jsx(_components.strong,{children:`Email`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Done`}),`.`]}),`\n`]}),_jsxs(Note,{children:[_jsx(_components.p,{children:`The SAML settings (ACS URL and Audience URI) are pre-configured by the Lovable integration. You do not need to enter any SAML values manually in Okta.`}),_jsxs(_components.p,{children:[`Because these settings cannot be changed, the catalog app does not support `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`IdP-initiated login`}),` yet. For now, users logging in through Okta must start login from Lovable.`]})]})]}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`In Lovable, choose between quick SAML provider setup or manual configuration:`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 1: Quick setup - import from metadata URL`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Okta, open the `,_jsx(_components.strong,{children:`Sign On`}),` tab of the Lovable application, scroll to `,_jsx(_components.strong,{children:`Metadata details`}),`, and copy the `,_jsx(_components.strong,{children:`Metadata URL`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In Lovable, paste the metadata URL in `,_jsx(_components.strong,{children:`Quick setup: import from metadata URL`}),` field.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Test \u0026 import`}),` to automatically populate the required fields below.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 2: Manual configuration`})}),_jsx(_components.p,{children:`Open the metadata URL in a new tab. Copy the following values and enter them in Lovable.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`SingleSignOnService Location`}),` → Lovable `,_jsx(_components.code,{children:`SAML SSO Sign-on URL (from your IdP)`})]}),`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`EntityID`}),` → Lovable `,_jsx(_components.code,{children:`Identity Provider Entity ID / Issuer`})]}),`\n`,_jsxs(_components.li,{children:[`Okta `,_jsx(_components.code,{children:`X509Certificate`}),` → Lovable `,_jsx(_components.code,{children:`X.509 signing certificates`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Paste the certificate value between the `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),` and `,_jsx(_components.code,{children:`-----END CERTIFICATE-----`}),` lines.`]})}),`\n`]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Finish SAML provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Configure SAML provider`}),`, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Okta as your SAML SSO provider.`]})})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`configure-auth0-as-your-sso-provider`,children:`Configure Auth0 as your SSO provider`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OIDC`,id:`oidc-3`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Create an application in Auth0`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Auth0 Admin Dashboard → Applications`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create application`}),`. Select the `,_jsx(_components.strong,{children:`Regular Web Applications`}),` application type.`]}),`\n`,_jsxs(_components.li,{children:[`Give the app a name, for example `,_jsx(_components.code,{children:`Lovable OIDC SSO`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`.`]}),`\n`]})}),_jsx(Step,{title:`Configure Allowed Callback URLs`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`In Auth0, go to your application settings.`}),`\n`,_jsxs(_components.li,{children:[`Add the `,_jsx(_components.strong,{children:`Allowed Callback URLs`}),`: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]})}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsxs(_components.p,{children:[`In Auth0, copy the following values from the `,_jsx(_components.strong,{children:`Settings`}),` tab and enter them in Lovable.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Domain`}),` → Lovable `,_jsx(_components.code,{children:`OIDC Issuer URL / Discovery Endpoint`}),` (include `,_jsx(_components.code,{children:`https://`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Client ID`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client ID / Application ID`})]}),`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Client Secret`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client Secret`})]}),`\n`,_jsxs(_components.li,{children:[`Optionally, the date the client secret expires → Lovable `,_jsx(_components.code,{children:`Client secret expiration (optional)`})]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Test the configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Test configuration`}),`. Lovable checks the issuer, client ID, and client secret and shows the outcome on the `,_jsx(_components.strong,{children:`Test results`}),` screen. Fix anything it reports, then click `,_jsx(_components.strong,{children:`Configure provider`}),`.`]})}),_jsx(Step,{title:`Finish OIDC provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Auth0 as your OIDC SSO provider.`]})})]})}),_jsx(Tab,{title:`SAML`,id:`saml-3`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Create an application in Auth0`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Auth0 Admin Dashboard → Applications.`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create application`}),`. Select the `,_jsx(_components.strong,{children:`Regular Web Applications`}),` application type.`]}),`\n`,_jsxs(_components.li,{children:[`Give the app a name, for example `,_jsx(_components.code,{children:`Lovable SAML SSO`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`.`]}),`\n`]})}),_jsx(Step,{title:`Configure Allowed Callback URLs`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`In Auth0, go to your application settings.`}),`\n`,_jsxs(_components.li,{children:[`Add the `,_jsx(_components.strong,{children:`Allowed Callback URLs`}),`: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]})}),_jsxs(Step,{title:`Configure SAML2 Web App Add-on`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Auth0, navigate to `,_jsx(_components.strong,{children:`Addons`}),`, and enable `,_jsx(_components.strong,{children:`SAML2 Web app`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Addon: SAML2 Web app → Settings`}),`, set:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Application Callback URL: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`Settings: paste the following `,_jsx(_components.code,{children:`mappings`}),` JSON`]}),`\n`]}),`\n`]}),`\n`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mappings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nameIdentifierFormat\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`]})})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Enable.`})]}),`\n`]})]}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`In Lovable, choose between quick SAML provider setup or manual configuration:`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 1: Quick setup - import from metadata URL`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Auth0 → Addon: SAML2 Web app → Usage`}),`, locate the `,_jsx(_components.strong,{children:`Identity Provider Metadata`}),`, and click the arrow icon to get the URL.`]}),`\n`,_jsxs(_components.li,{children:[`In Lovable, paste the metadata URL in `,_jsx(_components.strong,{children:`Quick setup: import from metadata URL`}),` field.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Test \u0026 import`}),` to automatically populate the required fields below.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 2: Manual configuration`})}),_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Auth0 → Addon: SAML2 Web app → Usage`}),`, copy the following `,_jsx(_components.strong,{children:`SAML Protocol Configuration Parameter`}),` values and enter them in Lovable.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Identity Provider Login URL`}),` → Lovable `,_jsx(_components.code,{children:`SAML SSO Sign-on URL (from your IdP)`})]}),`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Issuer`}),` → Lovable `,_jsx(_components.code,{children:`Identity Provider Entity ID / Issuer`})]}),`\n`,_jsxs(_components.li,{children:[`Auth0 `,_jsx(_components.code,{children:`Identity Provider Certificate`}),` (`,_jsx(_components.code,{children:`X509Certificate`}),`) → Lovable `,_jsx(_components.code,{children:`X.509 signing certificates`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Download Auth0 certificate and copy the `,_jsx(_components.code,{children:`X509Certificate`}),` value. Paste the certificate value between the `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),` and `,_jsx(_components.code,{children:`-----END CERTIFICATE-----`}),` lines.`]})}),`\n`]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Finish SAML provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Configure SAML provider`}),`, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Auth0 as your SAML SSO provider.`]})})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`configure-microsoft-entra-id-as-your-sso-provider`,children:`Configure Microsoft Entra ID as your SSO provider`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`OIDC`,id:`oidc-4`,children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Microsoft publishes its own walkthrough of this integration, `,_jsx(_components.a,{href:`https://learn.microsoft.com/en-us/entra/identity/saas-apps/lovable-oidc-tutorial`,children:`Configure Lovable (OIDC) for Single sign-on with Microsoft Entra ID`}),`, which covers the same setup as the steps below.`]})}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Add the Lovable app in Microsoft Entra ID`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.a,{href:`https://entra.microsoft.com`,children:`Microsoft Entra admin center`}),`, go to `,_jsx(_components.strong,{children:`Entra ID → Enterprise apps → New application`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Add from the gallery`}),` section, search for `,_jsx(_components.strong,{children:`Lovable`}),`, select it in the results, and add it to your tenant.`]}),`\n`,_jsxs(_components.li,{children:[`Open the app, go to `,_jsx(_components.strong,{children:`Single sign-on`}),`, and select `,_jsx(_components.strong,{children:`Go to application`}),` to open the app’s registration.`]}),`\n`]}),_jsx(Note,{children:_jsx(_components.p,{children:`Adding Lovable from the gallery replaces creating your own app registration. You still add the redirect URI, grant the permissions, and create a client secret in the steps below.`})})]}),_jsxs(Step,{title:`Add the Lovable redirect URI`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In the app’s registration, go to `,_jsx(_components.strong,{children:`Authentication`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Redirect URIs`}),`, add `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Configure`}),`.`]}),`\n`]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`The URL must match exactly, including the `,_jsx(_components.code,{children:`https://`}),` protocol.`]})})]}),_jsxs(Step,{title:`Configure the optional claims`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Microsoft Entra, go to `,_jsx(_components.strong,{children:`Token configuration → Add optional claim`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`ID token`}),` and add the `,_jsx(_components.code,{children:`email`}),` claim.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Add`}),`.`]}),`\n`]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`Lovable requires an email address in the ID token and has no fallback to the user principal name (UPN), so login fails for users whose token carries no `,_jsx(_components.code,{children:`email`}),` claim.`]})})]}),_jsx(Step,{title:`Configure the API permissions`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Microsoft Entra, go to `,_jsx(_components.strong,{children:`API permissions`}),`, and check that the `,_jsx(_components.strong,{children:`Microsoft Graph`}),` delegated permissions Lovable needs are listed:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`email`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`openid`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`profile`})}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`To add any that are missing, click `,_jsx(_components.strong,{children:`Add a permission → Microsoft Graph → Delegated permissions`}),`, select them, then click `,_jsx(_components.strong,{children:`Add permissions`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Grant admin consent`}),`.`]}),`\n`]})}),_jsx(Step,{title:`Create a client secret`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Microsoft Entra, go to `,_jsx(_components.strong,{children:`Certificates \u0026 secrets → Client secrets → New client secret`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Enter a description, choose an expiry, and click `,_jsx(_components.strong,{children:`Add`}),`. Note the expiration date so you can record it in Lovable.`]}),`\n`,_jsxs(_components.li,{children:[`Copy the secret `,_jsx(_components.strong,{children:`Value`}),` immediately. It isn’t shown again after you leave the page.`]}),`\n`]})}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`In Lovable, enter the following:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`OIDC Issuer URL / Discovery Endpoint`}),`: format the URL as `,_jsx(_components.code,{children:`https://login.microsoftonline.com/{TENANT_ID}/v2.0`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Replace the `,_jsx(_components.code,{children:`{TENANT_ID}`}),` with the `,_jsx(_components.strong,{children:`Directory (tenant) ID`}),` from the `,_jsx(_components.strong,{children:`Overview`}),` page in Microsoft Entra.`]})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Microsoft Entra `,_jsx(_components.code,{children:`Application (Client) ID`}),`, from the `,_jsx(_components.strong,{children:`Overview`}),` page → Lovable `,_jsx(_components.code,{children:`OAuth Client ID / Application ID`})]}),`\n`,_jsxs(_components.li,{children:[`The Microsoft Entra `,_jsx(_components.code,{children:`Client secret`}),` value you copied → Lovable `,_jsx(_components.code,{children:`OAuth Client Secret`})]}),`\n`,_jsxs(_components.li,{children:[`Optionally, the date the client secret expires → Lovable `,_jsx(_components.code,{children:`Client secret expiration (optional)`})]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Test the configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Test configuration`}),`. Lovable checks the issuer, client ID, and client secret and shows the outcome on the `,_jsx(_components.strong,{children:`Test results`}),` screen. Fix anything it reports, then click `,_jsx(_components.strong,{children:`Configure provider`}),`.`]})}),_jsx(Step,{title:`Finish OIDC provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Microsoft Entra ID as your OIDC SSO provider.`]})})]})]}),_jsx(Tab,{title:`SAML`,id:`saml-4`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Create an enterprise app in Microsoft Entra ID`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Microsoft Entra ID admin center → Enterprise applications`}),`, and select `,_jsx(_components.strong,{children:`New application`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Create your own application`}),` and choose `,_jsx(_components.strong,{children:`Integrate any other application you don’t find in the gallery (Non-gallery)`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Give the app a name, for example `,_jsx(_components.code,{children:`Lovable SAML SSO`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`. Your application is now created.`]}),`\n`]})}),_jsxs(Step,{title:`Configure SAML SSO`,children:[_jsxs(_components.p,{children:[`In Microsoft Entra, navigate to the `,_jsx(_components.strong,{children:`Single sign-on`}),` setup page and select `,_jsx(_components.strong,{children:`SAML`}),`. Under `,_jsx(_components.strong,{children:`Basic SAML Configuration`}),`, enter the following:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Identifier (Entity ID): `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`Reply URL (Assertion Consumer Service URL): `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`]}),_jsxs(_components.p,{children:[`Leave the other values blank and select `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`To let users log in to Lovable from the Microsoft `,_jsx(_components.strong,{children:`My Apps`}),` portal, add a second `,_jsx(_components.strong,{children:`Reply URL (Assertion Consumer Service URL)`}),`: `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`}),`, and select it as the `,_jsx(_components.strong,{children:`Default`}),` reply URL. See `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`Set up IdP-initiated login (SAML)`}),` for requirements.`]})})]}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`When the application is set up in Microsoft Entra, you can choose between quick SAML provider setup or manual configuration in Lovable.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 1: Quick setup - import from metadata URL`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In Microsoft Entra, go to `,_jsx(_components.strong,{children:`SAML Certificates`}),` and copy the `,_jsx(_components.strong,{children:`App Federation Metadata URL`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In Lovable, paste the `,_jsx(_components.strong,{children:`App Federation Metadata URL`}),` in `,_jsx(_components.strong,{children:`Quick setup: import from metadata URL`}),` field.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Test \u0026 import`}),` to automatically populate the required fields below.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 2: Manual configuration`})}),_jsx(_components.p,{children:`Copy the following values in Microsoft Entra and enter them in Lovable.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Microsoft Entra `,_jsx(_components.code,{children:`Login URL`}),` → Lovable `,_jsx(_components.code,{children:`SAML SSO Sign-on URL (from your IdP)`})]}),`\n`,_jsxs(_components.li,{children:[`Microsoft Entra `,_jsx(_components.code,{children:`Microsoft Entra Identifier`}),` → Lovable `,_jsx(_components.code,{children:`Identity Provider Entity ID / Issuer`})]}),`\n`,_jsxs(_components.li,{children:[`Microsoft Entra `,_jsx(_components.code,{children:`X509Certificate`}),` → Lovable `,_jsx(_components.code,{children:`X.509 signing certificates`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`You can download the certificate (Base 64) or open the `,_jsx(_components.code,{children:`App Federation Metadata URL`}),` in a new tab and copy the `,_jsx(_components.code,{children:`X509Certificate`}),` value. Paste the certificate value between the `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),` and `,_jsx(_components.code,{children:`-----END CERTIFICATE-----`}),` lines.`]})}),`\n`]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Finish SAML provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Configure SAML provider`}),`, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of Microsoft Entra ID as your SAML SSO provider.`]})})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-other-providers`,children:`Configure other providers`}),`\n`,_jsx(_components.p,{children:`You can configure any OIDC or SAML-compliant provider with Lovable SSO.`}),`\n`,_jsxs(_components.p,{children:[`Before you begin, complete `,_jsx(_components.a,{href:`#start-sso-setup-in-lovable`,children:`Start SSO setup in Lovable`}),` to get the settings and values you need to use in your IdP.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`OIDC`,id:`oidc-5`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Provider mapping`})}),_jsx(_components.p,{children:`Common field names across providers:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Redirect URI: `,_jsx(_components.code,{children:`Callback URL`}),`, `,_jsx(_components.code,{children:`Sign-in redirect URI`})]}),`\n`,_jsxs(_components.li,{children:[`Issuer/Domain: `,_jsx(_components.code,{children:`Issuer URL`}),`, `,_jsx(_components.code,{children:`Authority`}),`, `,_jsx(_components.code,{children:`Okta domain`}),`, `,_jsx(_components.code,{children:`Auth0 domain`}),`, `,_jsx(_components.code,{children:`Tenant domain`})]}),`\n`,_jsxs(_components.li,{children:[`Client credentials: `,_jsx(_components.code,{children:`Client ID`}),` and `,_jsx(_components.code,{children:`Client Secret`})]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Steps`})}),_jsxs(Steps,{children:[_jsx(Step,{title:`Create an OIDC confidential app`,children:_jsx(_components.p,{children:`Create a new OIDC Web application in your identity provider.`})}),_jsx(Step,{title:`Configure redirect URI`,children:_jsxs(_components.p,{children:[`In Redirect/Callback URLs, add `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]})}),_jsx(Step,{title:`Enable required scopes`,children:_jsxs(_components.p,{children:[`Ensure `,_jsx(_components.code,{children:`openid`}),` and `,_jsx(_components.code,{children:`email`}),` scopes are enabled and consented if needed.`]})}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`In your IdP, locate the corresponding values and enter them in Lovable:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Domain`}),` or `,_jsx(_components.code,{children:`Issuer URL`}),` → Lovable `,_jsx(_components.code,{children:`OIDC Issuer URL / Discovery Endpoint`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Client ID`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client ID / Application ID`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Client Secret`}),` → Lovable `,_jsx(_components.code,{children:`OAuth Client Secret`})]}),`\n`,_jsxs(_components.li,{children:[`Optionally, the date the client secret expires → Lovable `,_jsx(_components.code,{children:`Client secret expiration (optional)`})]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Test the configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Test configuration`}),`. Lovable checks the issuer, client ID, and client secret and shows the outcome on the `,_jsx(_components.strong,{children:`Test results`}),` screen. Fix anything it reports, then click `,_jsx(_components.strong,{children:`Configure provider`}),`.`]})}),_jsx(Step,{title:`Finish OIDC provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of your OIDC SSO provider.`]})})]})]}),_jsxs(Tab,{title:`SAML`,id:`saml-5`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Provider mapping`})}),_jsx(_components.p,{children:`Common field names across providers:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`ACS URL: `,_jsx(_components.code,{children:`Single Sign-On URL`}),`, `,_jsx(_components.code,{children:`SSO URL`}),`, `,_jsx(_components.code,{children:`Reply URL`}),`, `,_jsx(_components.code,{children:`Assertion Consumer Service URL`})]}),`\n`,_jsxs(_components.li,{children:[`Audience: `,_jsx(_components.code,{children:`SP Entity ID`}),`, `,_jsx(_components.code,{children:`Audience URI`}),`, `,_jsx(_components.code,{children:`Identifier`})]}),`\n`,_jsxs(_components.li,{children:[`Attribute mapping: `,_jsx(_components.code,{children:`Attribute Statements`}),`, `,_jsx(_components.code,{children:`User Attributes \u0026 Claims`})]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Steps`})}),_jsxs(Steps,{children:[_jsx(Step,{title:`Create a SAML 2.0 application`,children:_jsx(_components.p,{children:`Create a new SAML 2.0 application in your provider.`})}),_jsx(Step,{title:`Configure endpoints`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`ACS URL: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`,_jsxs(_components.li,{children:[`Audience / Entity ID: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`})]}),`\n`]})}),_jsx(Step,{title:`Map attributes`,children:_jsxs(_components.p,{children:[`Ensure `,_jsx(_components.code,{children:`email`}),` is included in the SAML assertion. `,_jsx(_components.code,{children:`displayName`}),` is optional.`]})}),_jsx(Step,{title:`Assign users`,children:_jsx(_components.p,{children:`Assign the application to users/groups who should access Lovable.`})}),_jsxs(Step,{title:`Provide Lovable with your IdP information`,children:[_jsx(_components.p,{children:`In Lovable, choose between quick SAML provider setup or manual configuration:`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 1: Quick setup - import from metadata URL`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`In your IdP, locate your SAML metadata URL (typically found in the SAML application settings or metadata details)`}),`\n`,_jsxs(_components.li,{children:[`In Lovable, paste the metadata URL in `,_jsx(_components.strong,{children:`Quick setup: import from metadata URL`}),` field.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Test \u0026 import`}),` to automatically populate the required fields below.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Option 2: Manual configuration`})}),_jsx(_components.p,{children:`In your IdP, locate the corresponding values and enter them in Lovable:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Login URL`}),` → Lovable `,_jsx(_components.code,{children:`SAML SSO Sign-on URL (from your IdP)`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Identifier/Issuer/Entity ID`}),` → Lovable `,_jsx(_components.code,{children:`Identity Provider Entity ID / Issuer`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`X509Certificate`}),` → Lovable `,_jsx(_components.code,{children:`X.509 signing certificates`})]}),`\n`]})]}),_jsxs(Step,{title:`Configure the display name and login URL`,children:[_jsx(_components.p,{children:`In Lovable, fill in the remaining fields:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Display Name`}),`: The name shown to users during authentication.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verified domain`}),`: The verified domain your login URL is based on. Lovable preselects it when you have only one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL suffix (optional)`}),`: An addition to the login URL, for example `,_jsx(_components.code,{children:`engineering`}),`. Lovable shows the resulting URL below the field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]}),`\n`]})]}),_jsx(Step,{title:`Finish SAML provider configuration in Lovable`,children:_jsxs(_components.p,{children:[`In Lovable, click `,_jsx(_components.strong,{children:`Configure SAML provider`}),`, review the confirmation page, then click `,_jsx(_components.strong,{children:`Confirm \u0026 enable SSO`}),` to finish the configuration of your SAML SSO provider.`]})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-idp-initiated-login-saml`,children:`Set up IdP-initiated login (SAML)`}),`\n`,_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`IdP-initiated SSO`}),`, users start login from your identity provider’s app portal (for example, an Okta dashboard tile or the Microsoft `,_jsx(_components.strong,{children:`My Apps`}),` portal) instead of from Lovable. IdP-initiated login is `,_jsx(_components.strong,{children:`optional`}),` and available for `,_jsx(_components.strong,{children:`SAML`}),` providers on `,_jsx(_components.strong,{children:`Business`}),` and `,_jsx(_components.strong,{children:`Enterprise`}),` plans. It requires no additional configuration in Lovable. SP-initiated login from Lovable keeps working as long as your IdP app still accepts the standard ACS URL (`,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`). If your provider has only one ACS URL field, use a dedicated app for IdP-initiated login so both flows keep working.`]}),`\n`,_jsx(Heading,{level:`3`,id:`requirements`,children:`Requirements`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A configured `,_jsx(_components.strong,{children:`SAML`}),` SSO provider. OIDC providers support SP-initiated login only.`]}),`\n`,_jsxs(_components.li,{children:[`Your workspace is the `,_jsx(_components.strong,{children:`only`}),` workspace that has verified your email domain. IdP-initiated login is disabled automatically while another workspace has the same domain verified.`]}),`\n`,_jsxs(_components.li,{children:[`Your IdP `,_jsx(_components.strong,{children:`signs`}),` the SAML response (or the assertion within it) and scopes it to the Lovable SP Entity ID (`,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`) through an Audience Restriction.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`When a requirement is not met (for example, a second workspace verifies the same email domain), IdP-initiated login stops working and users see an error page such as `,_jsx(_components.code,{children:`Forbidden`}),` or `,_jsx(_components.code,{children:`Unauthorized`}),`. Login from Lovable is not affected, and you can switch back to SP-initiated login only at any time. See `,_jsx(_components.a,{href:`#troubleshooting`,children:`Troubleshooting`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`enable-idp-initiated-login`,children:`Enable IdP-initiated login`}),`\n`,_jsxs(_components.p,{children:[`Configure your SAML app (or a dedicated IdP-initiated app) to post the SAML response to the IdP-initiated ACS URL: `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`})]}),`\n`,_jsxs(_components.p,{children:[`Keep the SP Entity ID / Audience URI unchanged: `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Okta`,id:`okta`,children:_jsx(Note,{children:_jsx(_components.p,{children:`The Lovable app in the Okta App Catalog does not support IdP-initiated login yet. Its SAML settings are pre-configured and cannot be changed. For now, users logging in through Okta must start login from Lovable.`})})}),_jsx(Tab,{title:`Microsoft Entra ID`,id:`microsoft-entra-id`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In your Lovable SAML enterprise application, go to `,_jsx(_components.strong,{children:`Single sign-on → Basic SAML Configuration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Add `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`}),` as an additional `,_jsx(_components.strong,{children:`Reply URL (Assertion Consumer Service URL)`}),` and select it as the `,_jsx(_components.strong,{children:`Default`}),` reply URL. Microsoft Entra sends IdP-initiated responses to the default reply URL.`]}),`\n`,_jsxs(_components.li,{children:[`Keep the `,_jsx(_components.strong,{children:`Identifier (Entity ID)`}),` as `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`, and select `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Users can now log in to Lovable from the `,_jsx(_components.strong,{children:`My Apps`}),` portal.`]}),`\n`]})}),_jsx(Tab,{title:`Auth0 and other providers`,id:`auth0-and-other-providers`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In your SAML application, set the ACS URL used for IdP-initiated login to `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`}),`. Providers also call this field `,_jsx(_components.strong,{children:`Single sign-on URL`}),`, `,_jsx(_components.strong,{children:`Reply URL`}),`, or `,_jsx(_components.strong,{children:`Assertion Consumer Service URL`}),`. In Auth0, it is the `,_jsx(_components.strong,{children:`Application Callback URL`}),` in the `,_jsx(_components.strong,{children:`SAML2 Web App`}),` addon. The addon has a single callback URL, so create a dedicated Auth0 application for IdP-initiated login.`]}),`\n`,_jsxs(_components.li,{children:[`Keep the Audience / Entity ID as `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`.`]}),`\n`,_jsx(_components.li,{children:`Make sure your provider signs SAML responses or assertions.`}),`\n`]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`IdP-initiated login is optional. If it does not work for your setup, point your SAML app back to `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`. This disables IdP-initiated login, and users log in from Lovable as usual. See `,_jsx(_components.a,{href:`#troubleshooting`,children:`Troubleshooting`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`map-idp-groups-to-workspace-roles`,children:`Map IdP groups to workspace roles`}),`\n`,_jsxs(_components.p,{children:[`You can map the groups your identity provider sends in its login claims to Lovable workspace roles, so people receive the right role automatically, and optionally restrict SSO login to mapped groups only. Mappings can also add members to your workspace `,_jsx(_components.a,{href:`/features/groups`,children:`groups`}),`. See `,_jsx(_components.a,{href:`#add-members-to-workspace-groups-automatically`,children:`Add members to workspace groups automatically`}),`. Group mappings work with both OIDC and SAML providers on `,_jsx(_components.strong,{children:`Business`}),` and `,_jsx(_components.strong,{children:`Enterprise`}),` plans.`]}),`\n`,_jsxs(_components.p,{children:[`To manage group mappings, go to `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) and find `,_jsx(_components.strong,{children:`Provisioning groups`}),`. There you can:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Map an IdP group to a workspace role.`}),` Click `,_jsx(_components.strong,{children:`Add group`}),`. In `,_jsx(_components.strong,{children:`Add provisioning group`}),`, enter the `,_jsx(_components.strong,{children:`Group name`}),` exactly as your IdP sends it, then choose a `,_jsx(_components.strong,{children:`Default role`}),`: `,_jsx(_components.strong,{children:`Viewer`}),`, `,_jsx(_components.strong,{children:`Editor`}),`, or `,_jsx(_components.strong,{children:`Admin`}),`. Workspace owners can also select `,_jsx(_components.strong,{children:`Owner`}),`. Click `,_jsx(_components.strong,{children:`Add`}),`. Users whose login includes a matching group claim get that role when they join. Claims must match mappings exactly, including capitalization. If several mapped groups match, the highest-privilege role wins.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Enable Group restriction.`}),` While it is disabled, matched users get their group’s role and everyone else logs in with the provider’s `,_jsx(_components.strong,{children:`Default role for new members`}),` (`,_jsx(_components.strong,{children:`Editor`}),` if you haven’t changed it). While it is enabled, only users whose IdP group matches one of your mappings can join the workspace through the provider. Everyone else is denied. Add the groups that need access before you enable the restriction, because no one can join through a provider that has no provisioning groups.`]}),`\n`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Your IdP must include group information in its login claims for mappings to match. See `,_jsx(_components.a,{href:`#send-group-claims-from-your-idp`,children:`Send group claims from your IdP`}),`.`]}),_jsxs(_components.p,{children:[`Role mapping and group membership sync also require `,_jsx(_components.a,{href:`/features/workspace-identity#sso-jit`,children:`SSO JIT`}),` (just-in-time provisioning) to be enabled. With JIT disabled, matched users log in without receiving a mapped role or group membership. `,_jsx(_components.strong,{children:`Group restriction`}),` applies either way.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`add-members-to-workspace-groups-automatically`,children:`Add members to workspace groups automatically`}),`\n`,_jsxs(_components.p,{children:[`Group mappings also provision group membership. When a user logs in through SSO with a group claim that matches a mapping, Lovable adds the user to the workspace `,_jsx(_components.a,{href:`/features/groups`,children:`group`}),` with the same name as that mapping.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Groups are matched by name.`}),` To add members to an existing Lovable group, enter its exact name in `,_jsx(_components.strong,{children:`Group name`}),`, including capitalization.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Lovable creates the group if it does not exist.`}),` The first matching login creates a workspace group named after the mapping and adds the user to it. Groups control access to projects, folders, and published apps, so review what a new group can access in `,_jsx(_components.a,{href:`https://lovable.dev/settings/groups`,children:`Groups`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Groups`}),`). Unmapped group claims never create groups.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SCIM-managed groups are the exception.`}),` If your workspace groups come from `,_jsx(_components.a,{href:`/features/business/scim`,children:`SCIM provisioning`}),`, Lovable does not create groups from login claims.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Membership is only added, never removed.`}),` Lovable does not remove anyone from a group based on login claims. Remove members from groups yourself if needed. To manage the full group lifecycle from your IdP, including removals, use `,_jsx(_components.a,{href:`/features/business/scim`,children:`SCIM provisioning`}),` on the `,_jsx(_components.strong,{children:`Enterprise`}),` plan.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`send-group-claims-from-your-idp`,children:`Send group claims from your IdP`}),`\n`,_jsxs(_components.p,{children:[`Lovable reads groups from a claim named `,_jsx(_components.code,{children:`groups`}),` in the login response, for both OIDC and SAML providers. The default SAML group claim names used by Microsoft Entra ID (`,_jsx(_components.code,{children:`http://schemas.microsoft.com/ws/2008/06/identity/claims/groups`}),`) and AD FS (`,_jsx(_components.code,{children:`http://schemas.xmlsoap.org/claims/Group`}),`) are also recognized, so you can keep those defaults.`]}),`\n`,_jsxs(_components.p,{children:[`The claim must contain group `,_jsx(_components.strong,{children:`names`}),`, not group IDs. Send names as multiple attribute values, or as a single value separated by commas or semicolons.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Okta`,id:`okta-2`,children:[_jsxs(_components.p,{children:[`Configure the group claim on your Lovable app in the `,_jsx(_components.strong,{children:`Okta Admin Console`}),`.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`SAML`})}),_jsx(_components.p,{children:`Where the group attribute is configured depends on how you added the Lovable app:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`App Catalog app`}),`: the app’s SAML settings are pre-configured and cannot be edited. Open the app’s `,_jsx(_components.strong,{children:`Sign On`}),` tab and look for a `,_jsx(_components.strong,{children:`Group Attribute Statements`}),` section there. If the app doesn’t offer one, it cannot send group claims: use the Lovable OIDC app instead, or create a custom SAML app following `,_jsx(_components.a,{href:`#configure-other-providers`,children:`Configure other providers`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom SAML app`}),`: open the app’s `,_jsx(_components.strong,{children:`General`}),` tab and click `,_jsx(_components.strong,{children:`Edit`}),` under `,_jsx(_components.strong,{children:`SAML Settings`}),`.`]}),`\n`]}),_jsx(_components.p,{children:`Add a group attribute statement with:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Name: `,_jsx(_components.code,{children:`groups`})]}),`\n`,_jsxs(_components.li,{children:[`Name format: `,_jsx(_components.code,{children:`Unspecified`})]}),`\n`,_jsxs(_components.li,{children:[`Filter: a filter matching the groups to send, for example `,_jsx(_components.strong,{children:`Matches regex`}),` `,_jsx(_components.code,{children:`.*`}),` to send all of the user’s groups.`]}),`\n`]}),_jsx(_components.p,{children:`Save your changes.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`OIDC`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Open your Lovable OIDC app and go to the `,_jsx(_components.strong,{children:`Sign On`}),` tab.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`OpenID Connect ID Token`}),`, click `,_jsx(_components.strong,{children:`Edit`}),` and set `,_jsx(_components.strong,{children:`Groups claim type`}),` to `,_jsx(_components.strong,{children:`Filter`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Set the groups claim name to `,_jsx(_components.code,{children:`groups`}),` with a filter matching the groups to send, for example `,_jsx(_components.strong,{children:`Matches regex`}),` `,_jsx(_components.code,{children:`.*`}),`.`]}),`\n`,_jsx(_components.li,{children:`Save your changes.`}),`\n`]}),_jsx(_components.p,{children:`Okta sends group names in the claim, so values match your mappings as long as the names line up.`})]}),_jsxs(Tab,{title:`Microsoft Entra ID`,id:`microsoft-entra-id-2`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In your Lovable enterprise application, go to `,_jsx(_components.strong,{children:`Single sign-on → Attributes \u0026 Claims → Edit`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Add a group claim`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Choose which groups to include. `,_jsx(_components.strong,{children:`Groups assigned to the application`}),` is recommended: it sends only the groups assigned to the Lovable app and avoids token size limits.`]}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.strong,{children:`Source attribute`}),` to an option that emits group `,_jsx(_components.strong,{children:`names`}),`, such as `,_jsx(_components.strong,{children:`Cloud-only group display names`}),`, or `,_jsx(_components.code,{children:`sAMAccountName`}),` for groups synced from on-premises Active Directory.`]}),`\n`,_jsx(_components.li,{children:`Save the claim. You can keep the default claim name: Lovable recognizes Microsoft Entra’s default group claim.`}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`By default, Microsoft Entra ID sends group `,_jsx(_components.strong,{children:`object IDs`}),` (GUIDs) instead of names. Object IDs never match name-based mappings, so make sure the claim’s source attribute emits group names.`]})})]}),_jsx(Tab,{title:`Other providers`,id:`other-providers`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In your SAML or OIDC application, include a group attribute or claim named `,_jsx(_components.code,{children:`groups`}),` in the login response.`]}),`\n`,_jsxs(_components.li,{children:[`Make sure the values are group `,_jsx(_components.strong,{children:`names`}),` (not IDs) and cover the groups you mapped in Lovable.`]}),`\n`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`manage-an-existing-sso-provider`,children:`Manage an existing SSO provider`}),`\n`,_jsxs(_components.p,{children:[`Workspace owners and admins can change a provider’s settings without deleting it. Go to `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) and click the provider in the `,_jsx(_components.strong,{children:`SSO providers`}),` section. The provider dialog includes these tabs:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`General`}),`: the `,_jsx(_components.strong,{children:`Display name`}),`, the `,_jsx(_components.strong,{children:`Login URL`}),` suffix, and the `,_jsx(_components.strong,{children:`Default role for new members`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connection`}),`: the settings Lovable uses to verify sign-ins from your identity provider. For SAML, the `,_jsx(_components.strong,{children:`Identity provider entity ID`}),`, the `,_jsx(_components.strong,{children:`Sign-on URL`}),`, and the `,_jsx(_components.strong,{children:`Signing certificates`}),`. For OIDC, the `,_jsx(_components.strong,{children:`Client ID`}),`, the `,_jsx(_components.strong,{children:`Issuer`}),`, and a new `,_jsx(_components.strong,{children:`Client secret`}),` with its expiration date. A new entity ID, client ID, or issuer moves the provider to a different identity provider. See `,_jsx(_components.a,{href:`#move-to-a-new-identity-provider`,children:`Move to a new identity provider`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Enterprise-managed authentication`}),`: enable, update, or disable access to Lovable from Claude through this provider. See `,_jsx(_components.a,{href:`/features/enterprise-managed-auth`,children:`Set up enterprise-managed authentication`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Manage group mappings and `,_jsx(_components.strong,{children:`Group restriction`}),` under `,_jsx(_components.strong,{children:`Provisioning groups`}),` on the `,_jsx(_components.strong,{children:`Identity`}),` page. See `,_jsx(_components.a,{href:`#map-idp-groups-to-workspace-roles`,children:`Map IdP groups to workspace roles`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Your changes take effect when you click `,_jsx(_components.strong,{children:`Save changes`}),`. Before Lovable saves a change on the `,_jsx(_components.strong,{children:`Connection`}),` tab, it checks the values. For SAML, Lovable validates the sign-on URL and reads every certificate. For OIDC, Lovable contacts your provider to check the new client secret. If a check fails, Lovable shows the error and keeps the current configuration. If Lovable cannot reach your provider, or your provider does not support checking a secret in advance, Lovable saves the new secret and shows a warning that it could not check the secret. Your provider then checks the secret at the next login. Each saved connection change appears in the `,_jsx(_components.a,{href:`/features/audit-logs`,children:`audit log`}),` as `,_jsx(_components.code,{children:`SSO connection updated`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`move-to-a-new-identity-provider`,children:`Move to a new identity provider`}),`\n`,_jsxs(_components.p,{children:[`When your workspace moves to a different identity provider, edit the existing SSO provider instead of deleting it. Editing keeps the settings that deleting disables, such as `,_jsx(_components.strong,{children:`Enforce SSO`}),`, `,_jsx(_components.a,{href:`/features/business/scim`,children:`SCIM provisioning`}),`, and the `,_jsx(_components.a,{href:`/features/workspace-identity#restrict-a-domain-to-sso-domain-lock`,children:`domain lock`}),`.`]}),`\n`,_jsx(_components.p,{children:`Members keep their accounts, but each account stays linked to the old identity provider. A member cannot log in through the new provider until that link is removed.`}),`\n`,_jsxs(_components.p,{children:[`Members with another login method can unlink the old provider in `,_jsx(_components.a,{href:`https://lovable.dev/settings/account#linked-accounts`,children:`Account settings → Account → Login methods`}),`. For members who log in only with SSO, contact Lovable support to remove the link.`]}),`\n`,_jsxs(_components.p,{children:[`Before you move the provider, delete its `,_jsx(_components.a,{href:`#map-idp-groups-to-workspace-roles`,children:`IdP group role mappings`}),` and disable `,_jsx(_components.a,{href:`/features/enterprise-managed-auth`,children:`enterprise-managed authentication`}),` for it. Both were set up for the old identity provider, so Lovable shows an error and does not save the move while either is still in place.`]}),`\n`,_jsxs(_components.p,{children:[`To move the provider, click it in the `,_jsx(_components.strong,{children:`SSO providers`}),` section of `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`). On the `,_jsx(_components.strong,{children:`Connection`}),` tab, enter the new provider’s details:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SAML`}),`: the new `,_jsx(_components.strong,{children:`Identity provider entity ID`}),`, and the new provider’s signing certificate under `,_jsx(_components.strong,{children:`Add a certificate`}),`. When you save, Lovable removes the current certificates and no longer accepts sign-ins signed by the old provider.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OIDC`}),`: the new `,_jsx(_components.strong,{children:`Client ID`}),`, the new `,_jsx(_components.strong,{children:`Issuer`}),`, or both, and the new provider’s `,_jsx(_components.strong,{children:`Client secret`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`When you save, Lovable asks you to confirm the change.`}),`\n`,_jsxs(_components.p,{children:[`You cannot change a provider between SAML and OIDC. A workspace has one SSO provider, so to change the protocol, delete the provider and set up a new one. See `,_jsx(_components.a,{href:`#delete-an-sso-provider`,children:`Delete an SSO provider`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`rotate-a-saml-signing-certificate`,children:`Rotate a SAML signing certificate`}),`\n`,_jsxs(_components.p,{children:[`You can add up to 10 signing certificates to a SAML provider, and Lovable accepts sign-ins signed with any of them. When your identity provider issues a new signing certificate, paste it under `,_jsx(_components.strong,{children:`Add a certificate`}),` on the `,_jsx(_components.strong,{children:`Connection`}),` tab before your provider starts using it, so login continues without interruption. Remove the old certificate with its delete icon after the switch. Each certificate shows its subject, fingerprint, and expiration date. Lovable warns when a certificate expires within 30 days and does not save a change that leaves only expired certificates.`]}),`\n`,_jsxs(_components.p,{children:[`During setup, `,_jsx(_components.strong,{children:`Test \u0026 import`}),` from your metadata URL adds the signing certificates listed in your metadata.`]}),`\n`,_jsx(Heading,{level:`3`,id:`track-the-oidc-client-secret-expiration`,children:`Track the OIDC client secret expiration`}),`\n`,_jsxs(_components.p,{children:[`Your identity provider does not share the expiration date of an OIDC client secret with Lovable, so you record it yourself. During setup, choose `,_jsx(_components.strong,{children:`3 months`}),`, `,_jsx(_components.strong,{children:`6 months`}),`, `,_jsx(_components.strong,{children:`12 months`}),`, `,_jsx(_components.strong,{children:`Custom`}),`, or `,_jsx(_components.strong,{children:`No expiration`}),` under `,_jsx(_components.strong,{children:`Client secret expiration (optional)`}),`. When you enter a new client secret on the `,_jsx(_components.strong,{children:`Connection`}),` tab, choose from the same options under `,_jsx(_components.strong,{children:`New secret expiration (optional)`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A badge next to the client secret on the `,_jsx(_components.strong,{children:`Connection`}),` tab shows its status:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Valid until`}),` and the date, while more than 30 days remain.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Expires in`}),` and the number of days, during the last 30 days.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Expires today`}),`, on the expiration date.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Expired`}),` and the date, after the expiration date has passed.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Lovable does not send a notification before a secret expires. Check the badge when you plan to create a new secret. When you enter a new secret without a date, Lovable clears the stored expiration date.`}),`\n`,_jsx(Heading,{level:`2`,id:`delete-an-sso-provider`,children:`Delete an SSO provider`}),`\n`,_jsxs(_components.p,{children:[`To change a provider’s sign-on URL, certificates, client secret, or identity provider, edit it instead of deleting it. See `,_jsx(_components.a,{href:`#manage-an-existing-sso-provider`,children:`Manage an existing SSO provider`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`To remove your workspace SSO provider, go to `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`), find the provider in the `,_jsx(_components.strong,{children:`SSO providers`}),` section, and click its delete icon.`]}),`\n`,_jsxs(_components.p,{children:[`Because a workspace can have only one SSO provider, deleting it turns off SSO for the workspace. Lovable shows a `,_jsx(_components.strong,{children:`Delete SSO provider`}),` confirmation dialog that lists what else it disables, based on your workspace’s current configuration:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Turn off Enforce SSO`}),`: members can use the workspace again without an SSO session.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Remove SCIM provisioning`}),`: the SCIM API key is revoked and SCIM-managed groups are deleted. Existing workspace members are not removed. See `,_jsx(_components.a,{href:`/features/business/scim`,children:`Set up SCIM user provisioning`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disable this workspace’s domain lock`}),`: people with emails on your `,_jsx(_components.a,{href:`/features/verified-domains`,children:`verified domains`}),` can create their own workspaces again, unless another workspace still locks the domain.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Delete `,_jsx(_components.em,{children:`n`}),` IdP group role mappings`]}),`, where `,_jsx(_components.em,{children:`n`}),` is your number of mappings: IdP groups no longer grant workspace roles on login.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The dialog lists each of these only when it applies to your workspace. Click `,_jsx(_components.strong,{children:`Delete provider`}),` to confirm.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting a provider cannot be undone. To use SSO again, you need to configure the provider again from the beginning. Lovable does not keep the previous configuration.`})}),`\n`,_jsxs(_components.p,{children:[`Members keep their workspace access after the provider is deleted. Members whose `,_jsx(_components.strong,{children:`only`}),` login method was that provider can recover their account themselves at the next login. See `,_jsx(_components.a,{href:`#recover-access-after-an-sso-provider-is-removed`,children:`Recover access after an SSO provider is removed`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Each side effect is recorded in the `,_jsx(_components.a,{href:`/features/audit-logs`,children:`audit log`}),`: both the `,_jsx(_components.code,{children:`SSO provider removed`}),` entry (with the exact settings that were turned off) and, when SCIM was configured, a separate `,_jsx(_components.code,{children:`SCIM disabled`}),` entry.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OIDC`,id:`oidc-6`,children:_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Invalid or mismatched Redirect URI`,id:`invalid-or-mismatched-redirect-uri`,children:_jsxs(_components.p,{children:[`Ensure the redirect/callback URL exactly matches `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),` in your IdP.`]})}),_jsxs(Accordion,{title:`Issuer URL / discovery fails`,id:`issuer-url-discovery-fails`,children:[_jsx(_components.p,{children:`Use the provider’s OIDC Issuer URL, not only the domain.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`For Okta, copy from the `,_jsx(_components.strong,{children:`Sign-on`}),` tab`]}),`\n`,_jsx(_components.li,{children:`For Auth0, use your tenant domain.`}),`\n`]})]}),_jsx(Accordion,{title:`Email not returned`,id:`email-not-returned`,children:_jsxs(_components.p,{children:[`Grant the `,_jsx(_components.code,{children:`email`}),` scope and ensure the user account has a primary email.`]})}),_jsx(Accordion,{title:`Authorization flow issues`,id:`authorization-flow-issues`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`Authorization Code`}),` with a confidential client and client secret. Avoid implicit or PKCE-only app types.`]})}),_jsx(Accordion,{title:`Login stops working after the client secret expires`,id:`login-stops-working-after-the-client-secret-expires`,children:_jsxs(_components.p,{children:[`Create a new client secret in your identity provider, then enter it on the provider’s `,_jsx(_components.strong,{children:`Connection`}),` tab in Lovable and record its expiration date. See `,_jsx(_components.a,{href:`#track-the-oidc-client-secret-expiration`,children:`Track the OIDC client secret expiration`}),`.`]})})]})}),_jsx(Tab,{title:`SAML`,id:`saml-6`,children:_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Invalid ACS or Audience`,id:`invalid-acs-or-audience`,children:_jsxs(_components.p,{children:[`Ensure both ACS and Audience/Entity ID exactly match `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),` in your IdP.`]})}),_jsxs(Accordion,{title:`Email claim missing`,id:`email-claim-missing`,children:[_jsx(_components.p,{children:`Make sure to map an email claim.`}),_jsxs(_components.p,{children:[`For Microsoft Entra ID, map `,_jsx(_components.code,{children:`email`}),` to `,_jsx(_components.code,{children:`user.mail`}),`. If `,_jsx(_components.code,{children:`user.mail`}),` is empty, use `,_jsx(_components.code,{children:`user.userprincipalname`}),`.`]})]}),_jsx(Accordion,{title:`Provider credentials invalid`,id:`provider-credentials-invalid`,children:_jsxs(_components.p,{children:[`Paste the correct `,_jsx(_components.code,{children:`X.509`}),` certificate. If your identity provider rotates its certificate, add the new one on the provider’s `,_jsx(_components.strong,{children:`Connection`}),` tab. See `,_jsx(_components.a,{href:`#rotate-a-saml-signing-certificate`,children:`Rotate a SAML signing certificate`}),`.`]})}),_jsxs(Accordion,{title:`Group mappings don't match`,id:`group-mappings-dont-match`,children:[_jsxs(_components.p,{children:[`If users get the default role instead of their mapped role, or `,_jsx(_components.strong,{children:`Group restriction`}),` denies people it shouldn’t:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Make sure the assertion includes a group attribute named `,_jsx(_components.code,{children:`groups`}),` (Microsoft Entra ID’s and AD FS’s default group claim names also work). See `,_jsx(_components.a,{href:`#send-group-claims-from-your-idp`,children:`Send group claims from your IdP`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Make sure the claim contains group `,_jsx(_components.strong,{children:`names`}),`, not IDs. Microsoft Entra ID sends object IDs unless the group claim’s source attribute is set to emit names.`]}),`\n`,_jsxs(_components.li,{children:[`Claim matching is `,_jsx(_components.strong,{children:`case-sensitive`}),`, so the value your IdP sends must match your mapping exactly, including capitalization.`]}),`\n`,_jsxs(_components.li,{children:[`Make sure `,_jsx(_components.a,{href:`/features/workspace-identity#sso-jit`,children:`SSO JIT`}),` is enabled. With it disabled, users log in without receiving mapped roles or group memberships.`]}),`\n`]})]}),_jsxs(Accordion,{title:`IdP-initiated login fails or shows an error page`,id:`idp-initiated-login-fails-or-shows-an-error-page`,children:[_jsxs(_components.p,{children:[`If starting login from your IdP’s app portal shows an error page (for example, `,_jsx(_components.code,{children:`Forbidden`}),` or `,_jsx(_components.code,{children:`Unauthorized`}),`):`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Make sure your email domain is verified in `,_jsx(_components.strong,{children:`only one`}),` Lovable workspace. IdP-initiated login is disabled automatically while more than one workspace has verified the same domain.`]}),`\n`,_jsxs(_components.li,{children:[`Make sure your IdP signs the SAML response (or the assertion within it) and the Audience Restriction matches `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`.`]}),`\n`,_jsx(_components.li,{children:`If your provider restricts access by group, make sure the user’s SAML assertion includes a matching group claim. This also applies when logging in from Lovable.`}),`\n`,_jsxs(_components.li,{children:[`If login still fails, change the ACS URL in your IdP app back to `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`. This disables IdP-initiated login and restores SP-initiated login from Lovable. IdP-initiated login is optional, so you can stay on SP-initiated login only and try again when the requirements are met.`]}),`\n`]})]})]})})]}),`\n`,_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`Recover access after an SSO provider is removed`,id:`recover-access-after-an-sso-provider-is-removed`,children:[_jsx(_components.p,{children:`Workspace members who only ever logged in through the deleted SSO provider can recover access themselves from the standard Lovable login page, with no admin action or support request required. When they enter their email on the login page, Lovable detects that their only login method was the removed provider and shows a recovery panel:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`If the workspace has a replacement SSO provider on the same verified domain,`}),` the panel shows `,_jsx(_components.strong,{children:`Reconnect your account`}),` with a login button for the new provider. Clicking it logs the user in with that provider and links the new identity to their existing account, so their projects, roles, and history are preserved. If linking cannot happen automatically (for example, the new provider does not verify the same email), the panel falls back to the password path below.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`If there is no replacement SSO provider,`}),` the panel shows `,_jsx(_components.strong,{children:`Set a password for your account`}),` and offers to email a link. The user opens the link, sets a password, and logs in with email and password from then on.`]}),`\n`]}),_jsx(_components.p,{children:`Users with any other working login method (password, Google, GitHub, Apple, or another still-valid SSO provider) are not affected and continue to log in normally.`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`I already have an account, but I'm joining a business workspace that uses SSO. How do I log in?`,id:`i-already-have-an-account-but-i-m-joining-a-business-workspace-that-uses-sso-how-do-i-log-in`,children:[_jsxs(_components.p,{children:[`If you created your account using another login method (such as email and password, Google, or GitHub), you need to log in that way `,_jsx(_components.strong,{children:`first`}),`. When you’re logged in, go to `,_jsx(_components.a,{href:`https://lovable.dev/settings/account#linked-accounts`,children:_jsx(_components.strong,{children:`Account settings → Account → Login methods`})}),` and click `,_jsx(_components.strong,{children:`Link account`}),` under `,_jsx(_components.strong,{children:`Link company account`}),`, then log in with your company SSO. This links your existing account to your company SSO.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Important:`}),` If you attempt to log in with SSO before linking your existing account, you’ll see an error. This is a security measure to prevent unauthorized access. Log in using your original method first to complete the linking process.`]})})]}),_jsxs(Accordion,{title:`Can members who log in with SSO use 'Forgot password?' on the login page?`,id:`can-members-who-log-in-with-sso-use-forgot-password-on-the-login-page`,children:[_jsxs(_components.p,{children:[`No. `,_jsx(_components.strong,{children:`Forgot password?`}),` only works for accounts that have an email and password login method.`]}),_jsxs(_components.p,{children:[`If your account logs in through `,_jsx(_components.strong,{children:`Google`}),`, `,_jsx(_components.strong,{children:`GitHub`}),`, `,_jsx(_components.strong,{children:`Apple`}),`, or a `,_jsx(_components.strong,{children:`SAML/OIDC SSO`}),` provider, Lovable does not send a password reset email and shows a `,_jsx(_components.strong,{children:`Password reset unavailable`}),` message, because completing a reset would add a password to an account that is meant to log in through your provider. Reset your credentials with your identity provider instead (for example, `,_jsx(_components.a,{href:`https://accounts.google.com`,children:`Google Account recovery`}),` or your company IdP).`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Exception for deleted SSO providers:`}),` if your only login method was an SSO provider that has since been removed from your workspace, you can set a password for the first time through the recovery flow on the login page. See `,_jsx(_components.a,{href:`#recover-access-after-an-sso-provider-is-removed`,children:`Recover access after an SSO provider is removed`}),`.`]})})]}),_jsx(Accordion,{title:`Which SSO providers does Lovable support?`,id:`which-sso-providers-does-lovable-support`,children:_jsx(_components.p,{children:`Lovable supports the industry-standard OIDC and SAML protocols, so you can integrate with any SSO provider that supports them.`})}),_jsx(Accordion,{title:`Does Lovable support multiple SSO providers per workspace?`,id:`does-lovable-support-multiple-sso-providers-per-workspace`,children:_jsxs(_components.p,{children:[`No. A workspace can have `,_jsx(_components.strong,{children:`one active SSO provider`}),` configured at a time.`]})}),_jsxs(Accordion,{title:`Can I enforce SSO for my workspace?`,id:`can-i-enforce-sso-for-my-workspace`,children:[_jsxs(_components.p,{children:[`Yes. The workspace `,_jsx(_components.strong,{children:`owner`}),` or `,_jsx(_components.strong,{children:`admin`}),` can enable `,_jsx(_components.strong,{children:`Enforce SSO`}),` in `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) and choose the `,_jsx(_components.strong,{children:`Session duration`}),` that sets how long users stay logged in before Lovable requires a new SSO login, from `,_jsx(_components.strong,{children:`8 hours`}),` to `,_jsx(_components.strong,{children:`30 days`}),`, or `,_jsx(_components.strong,{children:`Indefinite`}),` for no time limit.`]}),_jsxs(_components.p,{children:[`All workspace members must then log in through SSO. If your SSO provider is Google, a member who logs in with a Google Workspace account on your verified domain already has an SSO session and is not asked to log in again. When you enable it, Lovable asks whether to remove external collaborators from your projects. Invite links keep working only for people whose email is on one of your verified domains. See `,_jsx(_components.a,{href:`#enforce-sso`,children:`Enforce SSO`}),`.`]}),_jsxs(_components.p,{children:[`Test an SSO login first. For six hours after you add a provider, the `,_jsx(_components.strong,{children:`Enforce SSO`}),` toggle stays disabled and shows `,_jsx(_components.strong,{children:`Wait 6 hours and test SSO login before enforcing SSO`}),`.`]})]}),_jsxs(Accordion,{title:`Does Lovable support IdP-initiated SSO?`,id:`does-lovable-support-idp-initiated-sso`,children:[_jsxs(_components.p,{children:[`Yes. `,_jsx(_components.strong,{children:`SAML`}),` providers can optionally enable IdP-initiated login: users start login from your IdP’s app portal once your SAML app posts the SAML response to `,_jsx(_components.code,{children:`https://api.lovable.dev/sso/saml/idp-consume`}),`. It only works while your workspace is the only workspace that has verified your email domain, and SP-initiated login from Lovable keeps working either way. See `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`Set up IdP-initiated login (SAML)`}),`.`]}),_jsxs(_components.p,{children:[`OIDC providers support `,_jsx(_components.strong,{children:`SP-initiated login only`}),`: users must start login from Lovable.`]})]}),_jsxs(Accordion,{title:`What should I do if IdP-initiated login shows an error?`,id:`what-should-i-do-if-idp-initiated-login-shows-an-error`,children:[_jsxs(_components.p,{children:[`An error page such as `,_jsx(_components.code,{children:`Forbidden`}),` or `,_jsx(_components.code,{children:`Unauthorized`}),` means the `,_jsx(_components.a,{href:`#set-up-idp-initiated-login-saml`,children:`requirements`}),` are not met. First, make sure your email domain is verified in `,_jsx(_components.strong,{children:`only one`}),` Lovable workspace. IdP-initiated login is disabled automatically while more than one workspace has verified the same domain.`]}),_jsxs(_components.p,{children:[`If login still fails, change the ACS URL in your IdP app back to `,_jsx(_components.code,{children:`https://auth.lovable.dev/__/auth/handler`}),`. IdP-initiated login is optional: users log in from Lovable as usual, and you can try again when the requirements are met.`]})]}),_jsxs(Accordion,{title:`Does Lovable support just-in-time (JIT) provisioning with SSO?`,id:`does-lovable-support-just-in-time-jit-provisioning-with-sso`,children:[_jsxs(_components.p,{children:[`Yes, Lovable supports `,_jsx(_components.strong,{children:`JIT (just-in-time) provisioning`}),` through SSO. User accounts are created automatically the first time someone logs in via SSO, and they’re added to your company workspace.`]}),_jsxs(_components.p,{children:[`You can also set the provider’s `,_jsx(_components.strong,{children:`Default role for new members`}),` (`,_jsx(_components.strong,{children:`Viewer`}),`, `,_jsx(_components.strong,{children:`Editor`}),`, or `,_jsx(_components.strong,{children:`Admin`}),`), which applies when users join via SSO for the first time. If you don’t change it, JIT-created users join as an `,_jsx(_components.strong,{children:`Editor`}),`.`]}),_jsxs(_components.p,{children:[`On `,_jsx(_components.strong,{children:`Enterprise`}),` plans, workspace owners and admins can enable or disable `,_jsx(_components.strong,{children:`SSO JIT`}),` in `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity → User provisioning`}),`). The toggle appears once an SSO provider is configured.`]}),_jsxs(_components.p,{children:[`On `,_jsx(_components.strong,{children:`Business`}),` plans, SSO JIT is automatically enabled when an SSO provider is configured, and the row shows a read-only `,_jsx(_components.strong,{children:`Enabled`}),` or `,_jsx(_components.strong,{children:`Disabled`}),` status. Contact Lovable support if you need it changed. See `,_jsx(_components.a,{href:`/features/workspace-identity`,children:`Manage workspace identity and user provisioning`}),` for how the provisioning options work together.`]})]}),_jsxs(Accordion,{title:`What happens to existing members when I set up group mappings?`,id:`what-happens-to-existing-members-when-i-set-up-group-mappings`,children:[_jsx(_components.p,{children:`Existing members keep their current role. Lovable applies group-to-role mappings when someone joins the workspace through SSO. If several mapped groups match, the highest-privilege role wins.`}),_jsxs(_components.p,{children:[`On each SSO login, members are also added to any `,_jsx(_components.a,{href:`/features/groups`,children:`workspace groups`}),` whose names match their IdP group claims. Lovable never removes anyone from a group automatically. Remove members from groups yourself if needed.`]}),_jsxs(_components.p,{children:[`Enabling `,_jsx(_components.strong,{children:`Group restriction`}),` affects existing members: anyone logging in through the provider without a matching group claim is denied, so make sure your mappings cover everyone who should keep access. See `,_jsx(_components.a,{href:`#map-idp-groups-to-workspace-roles`,children:`Map IdP groups to workspace roles`}),`.`]})]}),_jsx(Accordion,{title:`Does Lovable create workspace groups from IdP group claims?`,id:`does-lovable-create-workspace-groups-from-idp-group-claims`,children:_jsxs(_components.p,{children:[`Yes, for mapped groups. When a login matches a mapping and your workspace has no `,_jsx(_components.a,{href:`/features/groups`,children:`group`}),` with that name, Lovable creates the group and adds the user to it. Unmapped group claims never create groups, and Lovable does not create groups from login claims when your workspace groups come from SCIM provisioning. See `,_jsx(_components.a,{href:`#add-members-to-workspace-groups-automatically`,children:`Add members to workspace groups automatically`}),`.`]})}),_jsxs(Accordion,{title:`Does Lovable support SCIM or automatic user provisioning?`,id:`does-lovable-support-scim-or-automatic-user-provisioning`,children:[_jsxs(_components.p,{children:[`Yes. Lovable supports `,_jsx(_components.strong,{children:`SCIM provisioning`}),` for automated user provisioning and deprovisioning on the `,_jsx(_components.strong,{children:`Enterprise plan`}),`.`]}),_jsx(_components.p,{children:`With SCIM, user creation, removal, and role assignment are managed centrally from your identity provider based on assignments and group membership.`}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/features/business/scim`,children:`Set up SCIM user provisioning`}),` for more information.`]})]}),_jsxs(Accordion,{title:`How can I find my tenant ID (SSO login identifier)?`,id:`how-can-i-find-my-tenant-id-sso-login-identifier`,children:[_jsxs(_components.p,{children:[`Your tenant ID is the `,_jsx(_components.code,{children:`{tenantId}`}),` value in your `,_jsx(_components.strong,{children:`SSO login URL`}),`, `,_jsx(_components.code,{children:`https://lovable.dev/sso-login/{tenantId}`}),`. It is your verified domain with dots replaced by hyphens, plus the optional `,_jsx(_components.strong,{children:`Login URL suffix`}),` you entered during setup.`]}),_jsxs(_components.p,{children:[`After setup, the full URL appears in the `,_jsx(_components.strong,{children:`SSO providers`}),` row in `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) and in the provider’s `,_jsx(_components.strong,{children:`Login URL`}),` field. See `,_jsx(_components.a,{href:`#your-sso-login-url`,children:`Your SSO login URL`}),`.`]})]}),_jsxs(Accordion,{title:`How can I edit my SSO provider configuration?`,id:`how-can-i-edit-my-sso-provider-configuration`,children:[_jsxs(_components.p,{children:[`Click the provider in `,_jsx(_components.a,{href:`https://lovable.dev/settings/identity`,children:`Identity`}),` (`,_jsx(_components.strong,{children:`Workspace settings → Access → Identity`}),`) to open its settings. On the `,_jsx(_components.strong,{children:`General`}),` tab you can change the `,_jsx(_components.strong,{children:`Display name`}),`, the `,_jsx(_components.strong,{children:`Login URL`}),` suffix, and the `,_jsx(_components.strong,{children:`Default role for new members`}),`, then click `,_jsx(_components.strong,{children:`Save changes`}),`. The `,_jsx(_components.strong,{children:`Connection`}),` tab lets you change the SAML sign-on URL and signing certificates, or enter a new OIDC client secret and its expiration date. Manage group mappings and `,_jsx(_components.strong,{children:`Group restriction`}),` under `,_jsx(_components.strong,{children:`Provisioning groups`}),` on the `,_jsx(_components.strong,{children:`Identity`}),` page.`]}),_jsxs(_components.p,{children:[`Use the `,_jsx(_components.strong,{children:`Enterprise-managed authentication`}),` tab to `,_jsx(_components.a,{href:`/features/enterprise-managed-auth`,children:`manage access from Claude`}),`.`]}),_jsxs(_components.p,{children:[`To move to a new identity provider, change the entity ID, issuer, or client ID on the `,_jsx(_components.strong,{children:`Connection`}),` tab. See `,_jsx(_components.a,{href:`#move-to-a-new-identity-provider`,children:`Move to a new identity provider`}),`.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Deleting the provider also turns off Enforce SSO, removes SCIM provisioning (revoking the SCIM API key and deleting SCIM-managed groups), disables the verified-domain lock, and deletes any IdP group role mappings. The delete dialog lists exactly which of these apply before you confirm. See `,_jsx(_components.a,{href:`#delete-an-sso-provider`,children:`Delete an SSO provider`}),`.`]})})]}),_jsx(Accordion,{title:`What happens to users who only logged in via SSO if we delete the provider?`,id:`what-happens-to-users-who-only-logged-in-via-sso-if-we-delete-the-provider`,children:_jsxs(_components.p,{children:[`They keep their workspace access and can recover their account themselves from the login page: either by logging in through a replacement SSO provider (Lovable links the new identity to their existing account) or by setting a password through an emailed link. See `,_jsx(_components.a,{href:`#recover-access-after-an-sso-provider-is-removed`,children:`Recover access after an SSO provider is removed`}),`.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Set up workspace single sign-on (SSO)","sidebarTitle":"Workspace SSO","description":"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.","keywords":["single sign-on","sso","SSO setup","SSO configuration","SSO integration","enterprise SSO","enforce SSO","identity provider","OIDC","SAML","Okta SSO","Auth0 SSO","Microsoft Entra ID SSO","Azure AD SSO","Google Workspace SSO","logging in twice","SSO group mapping","group claims","group-based provisioning","group restriction","IdP groups","IdP-initiated SSO","IdP-initiated SAML"],"href":"/features/business/sso"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported SSO protocols","slug":"supported-sso-protocols","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Start SSO setup in Lovable","slug":"start-sso-setup-in-lovable","depth":2,"children":[{"title":"IdP configuration reference","slug":"idp-configuration-reference","depth":3,"children":[]},{"title":"Your SSO login URL","slug":"your-sso-login-url","depth":3,"children":[]},{"title":"Enforce SSO","slug":"enforce-sso","depth":3,"children":[]}]},{"title":"Provider-specific setup guides","slug":"provider-specific-setup-guides","depth":2,"children":[{"title":"Configure Okta as your SSO provider","slug":"configure-okta-as-your-sso-provider","depth":3,"children":[]},{"title":"Configure Auth0 as your SSO provider","slug":"configure-auth0-as-your-sso-provider","depth":3,"children":[]},{"title":"Configure Microsoft Entra ID as your SSO provider","slug":"configure-microsoft-entra-id-as-your-sso-provider","depth":3,"children":[]}]},{"title":"Configure other providers","slug":"configure-other-providers","depth":2,"children":[]},{"title":"Set up IdP-initiated login (SAML)","slug":"set-up-idp-initiated-login-saml","depth":2,"children":[{"title":"Requirements","slug":"requirements","depth":3,"children":[]},{"title":"Enable IdP-initiated login","slug":"enable-idp-initiated-login","depth":3,"children":[]}]},{"title":"Map IdP groups to workspace roles","slug":"map-idp-groups-to-workspace-roles","depth":2,"children":[{"title":"Add members to workspace groups automatically","slug":"add-members-to-workspace-groups-automatically","depth":3,"children":[]},{"title":"Send group claims from your IdP","slug":"send-group-claims-from-your-idp","depth":3,"children":[]}]},{"title":"Manage an existing SSO provider","slug":"manage-an-existing-sso-provider","depth":2,"children":[{"title":"Move to a new identity provider","slug":"move-to-a-new-identity-provider","depth":3,"children":[]},{"title":"Rotate a SAML signing certificate","slug":"rotate-a-saml-signing-certificate","depth":3,"children":[]},{"title":"Track the OIDC client secret expiration","slug":"track-the-oidc-client-secret-expiration","depth":3,"children":[]}]},{"title":"Delete an SSO provider","slug":"delete-an-sso-provider","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lovable-f9060f1e/84f62c0d01f1469d/sign-in-with-lovable-demo.js"],"subdomain":"lovable-f9060f1e","siteName":"Lovable Documentation","title":"Set up workspace single sign-on (SSO) - Lovable Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6ae3962568451bd92910166e","deploymentId":"672cd6fd3133ca8082eceab1","questionText":"How do I enable SSO for my workspace?","status":"active","generatedBy":"contextual","path":"features/business/sso","createdAt":"2026-10-29T18:53:25.668Z","updatedAt":"2026-10-29T18:53:25.668Z","__v":0},{"_id":"6ae3962568451bd92910166f","deploymentId":"672cd6fd3133ca8082eceab1","questionText":"Which identity providers are supported?","status":"active","generatedBy":"contextual","path":"features/business/sso","createdAt":"2026-10-29T18:53:25.668Z","updatedAt":"2026-10-29T18:53:25.668Z","__v":0},{"_id":"6ae3962568451bd929101670","deploymentId":"672cd6fd3133ca8082eceab1","questionText":"Can I use IdP-initiated login?","status":"active","generatedBy":"contextual","path":"features/business/sso","createdAt":"2026-10-29T18:53:25.668Z","updatedAt":"2026-10-29T18:53:25.668Z","__v":0}],"lastModified":"2026-11-18T06:45:43.752Z","originalFileLocation":"features/business/sso.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lovable Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up workspace single sign-on (SSO) - Lovable Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lovable Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lovable.dev/features/business/sso\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lovable-f9060f1e.mintlify.site/assets/logo/opengraph-image.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Set up workspace single sign-on (SSO) - Lovable Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lovable-f9060f1e.mintlify.site/assets/logo/opengraph-image.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lovable-f9060f1e/AU_uVgnksniw8mje/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lovable Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0095FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lovable.dev/features/business/sso\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/business/sso.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lovable.dev/#organization\",\"name\":\"Lovable Documentation\",\"url\":\"https://docs.lovable.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lovable-f9060f1e/lZT1ihBcprll2Agr/assets/logo/logoblack.svg?fit=max\u0026auto=format\u0026n=lZT1ihBcprll2Agr\u0026q=85\u0026s=8d9eafaf19f94e27f0d13ac160d54f54\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lovable.dev#website\",\"name\":\"Lovable Documentation\",\"url\":\"https://docs.lovable.dev\",\"publisher\":{\"@id\":\"https://docs.lovable.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lovable.dev/features/business/sso#webpage\",\"url\":\"https://docs.lovable.dev/features/business/sso\",\"name\":\"Set up workspace single sign-on (SSO)\",\"description\":\"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\",\"dateModified\":\"2026-11-18T06:45:43.752Z\",\"isPartOf\":{\"@id\":\"https://docs.lovable.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lovable.dev/features/business/sso#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lovable.dev/features/business/sso#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workspace \u0026 account\",\"item\":\"https://docs.lovable.dev/features/workspace-admin-settings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Access\",\"item\":\"https://docs.lovable.dev/features/people\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Identity\",\"item\":\"https://docs.lovable.dev/features/workspace-identity\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Set up workspace single sign-on (SSO)\",\"item\":\"https://docs.lovable.dev/features/business/sso\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.lovable.dev/features/business/sso#article\",\"headline\":\"Set up workspace single sign-on (SSO)\",\"name\":\"Set up workspace single sign-on (SSO)\",\"description\":\"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.\",\"url\":\"https://docs.lovable.dev/features/business/sso\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lovable.dev/features/business/sso#webpage\"},\"image\":\"https://docs.lovable.dev/assets/logo/opengraph-image.png\",\"dateModified\":\"2026-11-18T06:45:43.752Z\",\"keywords\":\"single sign-on, sso, SSO setup, SSO configuration, SSO integration, enterprise SSO, enforce SSO, identity provider, OIDC, SAML, Okta SSO, Auth0 SSO, Microsoft Entra ID SSO, Azure AD SSO, Google Workspace SSO, logging in twice, SSO group mapping, group claims, group-based provisioning, group restriction, IdP groups, IdP-initiated SSO, IdP-initiated SAML\",\"publisher\":{\"@id\":\"https://docs.lovable.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lovable.dev#website\"}}]}\u003c/script>","agentPointerHref":"/features/business/sso.md","siteName":"Lovable Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"Welcome to Lovable","description":"Lovable is a full-stack AI development platform for building, iterating on, and deploying web applications using natural language, with real code, security, and enterprise governance.","keywords":["lovable","ai development platform","full-stack web applications","natural language development","ai-assisted development","production-grade applications","workspaces and projects","presentations and slide decks","image generation","enterprise security","sso scim 2fa","security and compliance","soc 2 iso 27001 gdpr"],"href":"/introduction/welcome"},{"title":"Create an account","description":"Create your Lovable account to start building and iterating on full-stack web applications using natural language.","keywords":["create account","sign up Lovable","register account","Lovable signup","free account","email signup","Google login","GitHub login","Apple login","Google One Tap","continue with Google card","single sign on","SSO login","SAML OIDC","account registration","new user onboarding","personal workspace","free plan credits","Lovable dashboard","account vs workspace","user account setup","join Lovable","reset password","forgot password","password requirements","compromised password","breached password","insecure password","logged out of all devices","can't log in","login problems","suspicious activity","registration denied","login denied","sign up blocked","email alias","plus addressing","captcha"],"href":"/introduction/create-an-account"},{"title":"Quick start","description":"Build and publish your first Lovable app in about ten minutes, from your first prompt to a live URL you can share.","keywords":["quick start","getting started","first app","first project","build an app with AI","publish first app","lovable tutorial","no code app builder"],"href":"/introduction/getting-started"},{"title":"Dashboard overview","description":"Learn how to navigate the Lovable dashboard, start new projects, and access your workspace settings.","keywords":["lovable dashboard","dashboard overview","new project","new chat","chats","all chats","build chat plan","sidebar navigation","resize sidebar","command palette","workspace selector","user menu","keyboard shortcuts","notifications","project tabs"],"href":"/introduction/dashboard-overview"},{"title":"Lovable for Enterprise","sidebarTitle":"Enterprise","description":"Build and ship AI-generated apps at organizational scale with the security, governance, identity, and compliance controls your security team expects.","keywords":["lovable enterprise","lovable for enterprise","enterprise plan","enterprise features","lovable security","lovable governance","lovable compliance","lovable sso","lovable scim","lovable mfa","lovable audit logs","lovable data residency","lovable workspace","lovable business plan","lovable databricks","lovable snowflake","lovable bigquery","gemini enterprise","scheduled security scans","deep scan","quick scan","basic scan","chat send protection","block publishing with pii","app login methods","auto-fix security issues","project transfer controls"],"href":"/introduction/lovable-for-enterprise"},{"group":"Lovable platforms","pages":[{"title":"Lovable desktop app","sidebarTitle":"Lovable desktop app","description":"Use Lovable as a native desktop application. Connect local tools, switch between your chats and projects, and work faster with keyboard shortcuts.","keywords":["Lovable desktop app","desktop application","local MCP","Figma MCP","Paper MCP","macOS app","Windows app","download Lovable","desktop vs web","system tray","multi-tab","chat switcher","keyboard shortcuts","local tools"],"href":"/integrations/desktop-app"},{"title":"Lovable mobile app","sidebarTitle":"Lovable mobile app","description":"Use the Lovable app for iOS and Android to build projects, chat with Lovable, and review your work from your phone or tablet.","href":"/integrations/lovable-mobile-app"}]},{"group":"Use Lovable from other tools","pages":[{"title":"Lovable API","sidebarTitle":"Lovable API","description":"Use the Lovable API to deploy Lovable projects, manage your workspace, query security scans, and embed projects in your product.","keywords":["Lovable API","REST API","public API","API key","programmatic","automation"],"href":"/integrations/lovable-api"},{"title":"Lovable MCP server","sidebarTitle":"Lovable MCP server","description":"Connect AI agents and developer tools to Lovable using the Model Context Protocol. Build, iterate, and deploy apps programmatically.","keywords":["MCP","MCP server","Model Context Protocol","agent","API","ChatGPT","Claude Desktop","Claude Code","OpenAI Codex","Cursor","VS Code","programmatic","developer platform","automation"],"href":"/integrations/lovable-mcp-server"},{"title":"Lovable ChatGPT app","sidebarTitle":"Lovable ChatGPT app","description":"Turn your ChatGPT brainstorms into full-stack apps by tagging @Lovable directly in your conversations.","keywords":["Lovable ChatGPT app","ChatGPT app builder","build apps from ChatGPT","turn ChatGPT conversations into apps","ChatGPT integration","how to build an app from a ChatGPT conversation","turn ideas into apps using ChatGPT"],"href":"/tips-tricks/chatgpt-app"},{"title":"Chat with Lovable in Slack","sidebarTitle":"Lovable in Slack","description":"Chat with Lovable directly in Slack. Mention @Lovable in a channel or send it a DM to create projects, update your apps, and get answers about them.","keywords":["Slack","Lovable in Slack","Lovable app for Slack","Lovable for Slack","Slack app","Slack agent","Slack bot","@Lovable","add Lovable to Slack"],"href":"/integrations/lovable-for-slack"},{"title":"Chat with Lovable in Telegram","sidebarTitle":"Lovable in Telegram","description":"Chat with the Lovable bot in Telegram to build and manage your projects. Not for integrating Telegram messaging into your apps.","keywords":["Lovable Telegram","Telegram bot","Lovable Telegram bot","build apps from Telegram","Lovable mobile","Telegram integration","Lovable assistant Telegram"],"href":"/tips-tricks/lovable-telegram-bot"},{"title":"Build with URL","description":"Build and share Lovable apps from simple URLs, with reference images and web pages.","keywords":["Build with URL","Create apps from URL","build with lovable","reference web page"],"href":"/integrations/build-with-url"},{"title":"Sign in with Lovable","sidebarTitle":"Sign in with Lovable","description":"Let people sign in to your site with their Lovable account, with a drop-in button or the standard OpenID Connect flow. Available on all plans.","keywords":["Sign in with Lovable","Lovable login","sign in button","authentication","Lovable account","OAuth","OpenID Connect","OIDC","authorization code","PKCE","Log in with Lovable","ID token"],"href":"/integrations/sign-in-with-lovable"}]}]},{"group":"Build","icon":"hammer","pages":[{"group":"Projects","root":{"title":"Projects in Lovable","sidebarTitle":"Overview","description":"What a project is in Lovable and how to work with one: create, organize, and publish projects, manage roles and ownership, and safely move or delete them.","keywords":["lovable project","what is a lovable project","create project","how to create a project in lovable","project url","project subdomain","rename project","pin project","star project","project folders","organize projects","move project to another workspace","project owner","project roles","project permissions","unpublished project"],"href":"/features/projects/overview"},"pages":[{"title":"Find your way around the Lovable editor","sidebarTitle":"Editor","description":"A guided map of the Lovable editor: where every tool lives, from the chat panel and live preview to the project toolbar, More menu, and keyboard shortcuts.","keywords":["lovable editor","project editor","editor layout","lovable interface","where is cloud in lovable","where is the code editor in lovable","analytics tab","more menu","project toolbar","drafts switcher","project settings","editor sidebar","command palette","lovable keyboard shortcuts"],"href":"/features/projects/editor"},{"title":"Work with Lovable in the project chat","sidebarTitle":"Project chat","description":"Everything you can do in the project chat panel in the editor. Write or dictate prompts, attach files, send follow-ups to steer Lovable while it works, answer Lovable's questions, undo changes, and fix errors.","keywords":["project chat","lovable chat","chat panel","chat mode","lovable prompts","prompt box","voice dictation","attach file to lovable","attach pdf","attach figma","attach .fig",".fig file","add reference","message queue","interjections","send follow-up","steering","steer lovable","build mode","plan mode","edit message","try to fix","fix errors in lovable","add images to my app","replace image","image generation","generate an image","edit an image","video generation","embed video","how to undo in lovable","stop lovable mid task","question card","async questions","skip a question"],"href":"/features/projects/chat"},{"title":"Preview and test your app in Lovable","sidebarTitle":"Preview","description":"See your app running live while you build. Test phone, tablet, and desktop sizes, try complete flows before you publish, and share progress with a preview link.","keywords":["lovable preview","live preview","app preview","test my app","testing environment","device preview","mobile preview","refresh preview","preview not loading","preview paused","share preview link","open preview in new tab","preview vs published site"],"href":"/features/projects/preview"},{"title":"Explore changes with drafts","sidebarTitle":"Drafts","description":"Create drafts to test changes, including database changes, in a copy of your project, and accept the ones you want to keep.","keywords":["drafts","draft","project drafts","create a draft","accept draft","update draft","delete draft","test changes","explore changes","compare versions","design variants","variants","staging","staging environment","test environment","development environment","dev and production","test database","seed data","isolated backend","branch","branches","branching","fork","merge","rebase","version control","project versions","database changes in a draft"],"href":"/features/drafts"},{"title":"View and edit your project's code","sidebarTitle":"Code editor","description":"Open the code editor in Lovable to browse and search your app's source code, make manual edits, reference exact lines in the project chat, and download your codebase.","keywords":["lovable code editor","view code","how to see code in lovable","edit code","source code","save code changes","download codebase","lovable export code","download source code","reference file in the project chat","line reference","search code","markdown preview","format code"],"href":"/features/code-mode"},{"title":"Revert and restore your project with version history","sidebarTitle":"Version history","description":"Lovable saves every change as a version automatically. Preview old versions of your project, revert to an earlier state, and bookmark stable versions.","keywords":["version history","lovable revert","how to undo in lovable","revert project","restore version","restore old version","rollback changes","previous version","bookmarks","undo last change","revert to this version"],"href":"/features/projects/history"},{"title":"Project settings","sidebarTitle":"Settings","description":"Every Lovable project setting in one reference: rename a project, change its URL, control publishing and sharing, connect Git, manage domains, or delete a project.","keywords":["lovable project settings","project settings","rename project","change project url","URL subdomain","project type","project category","hide lovable badge","unpublish project","public remixing","transfer project ownership","move project","transfer project to another account","project monitoring settings","git settings","AI edits count"],"href":"/features/projects/settings"},{"title":"Delete a project","description":"Delete a project you no longer need, learn what happens to its app and data, and restore it within 60 days if you change your mind.","keywords":["recover deleted project","undelete project","accidentally deleted project","project trash","recycle bin","60 day grace period","project recovery"],"href":"/features/projects/delete-project"},{"title":"Remix a project","sidebarTitle":"Remix","description":"Remix a Lovable project to create your own independent copy. Learn what carries over to the copy, who can remix your project, and how to move projects between accounts.","keywords":["remix a project","remix a template","Lovable templates","lovable remix","duplicate project","copy project","clone project","fork project","public remixing","include project history","copy project to another workspace","transfer project to another account","backup project"],"href":"/features/projects/remix"},{"title":"Import a project from Replit, Bolt, v0, or another tool","sidebarTitle":"Import a project","description":"Bring an app from Replit, Manus, Bolt, Base44, v0, or any ZIP of code into Lovable. Lovable migrates the code and moves your database and users to Lovable's built-in backend.","keywords":["import project","migrate to Lovable","move my app to Lovable","switch to Lovable","Replit import","Base44 import","Bolt import","v0 import","Manus import","upload zip","import code","import GitHub repository","external project import","migration"],"href":"/features/projects/import-project"},{"title":"Import a website into Lovable from its URL","sidebarTitle":"Import a website","description":"Rebuild a website you own from its URL as a Lovable project you can edit in chat. Learn what Lovable reads from the page and how to add more pages.","keywords":["import website","clone website","recreate website","rebuild my website","website to Lovable","move my site from Wix","move my site from Squarespace","WordPress to Lovable","Webflow to Lovable","copy my website","paste website URL","redesign existing website"],"href":"/features/projects/import-website"},{"title":"Upgrade a project to TanStack Start","sidebarTitle":"Upgrade to TanStack Start","description":"Upgrade an older React + Vite project to TanStack Start, Lovable's latest template, so your pages render on the server, improving search visibility and social link previews.","keywords":["upgrade to TanStack Start","migrate to TanStack Start","TanStack migration","upgrade template","Lovable Classic","React Vite migration","server-side rendering","SSR","SEO","link previews","latest template"],"href":"/features/upgrade-to-tanstack-start"},{"title":"Find and search projects","sidebarTitle":"Find a project","description":"Use the command palette, filters, and sorting to quickly find any project in your workspace.","keywords":["search projects","find projects","command palette","filter projects","sort projects","project search","project list","grid view","list view","workspace search","filter by owner","filter by creator","shared with me","starred projects"],"href":"/introduction/project-search-and-find"},{"title":"Organize projects in folders","sidebarTitle":"Folders","description":"Group related projects into folders to keep your workspace organized.","href":"/introduction/project-folders"}]},{"title":"Chat with Lovable across your workspace","sidebarTitle":"Chats","description":"Chats is where you work with Lovable outside a project: think through ideas, ask about your apps and workspace, use your connected tools, create files, talk by voice, and send work to a project when you are ready to build.","keywords":["chats","lovable chats","chat with lovable","workspace chat","new chat","all chats","lovable.dev/chats","voice conversation","talk to lovable","daily chat allowance","chat credits","chat for free","brainstorm with lovable","ask about my apps","send work to a project","chat about this project"],"href":"/features/chats"},{"title":"Automations: schedule recurring work with Lovable","sidebarTitle":"Automations","description":"Set up recurring checks, weekly digests, and project upkeep on a schedule. See how each run went, and change or pause an automation from your dashboard.","keywords":["scheduled tasks","recurring tasks","daily report","weekly digest","reminders","automation didn't run","automation out of credits","automation costs credits"],"href":"/features/automations"},{"group":"The agent","pages":[{"title":"Discuss your app in Chat mode","sidebarTitle":"Chat mode","description":"Chat mode is the Chat option in the project chat. Discuss the app you have open and decide what to change without changing any code. Each message is priced as a chat message, covered first by the daily chat allowance.","keywords":["chat mode lovable","ask anything explore ideas","project chat modes","build chat plan","switch to build mode","read-only mode"],"href":"/features/chat-mode"},{"title":"Plan a change in Plan mode","sidebarTitle":"Plan mode","description":"Plan mode investigates your project and writes a structured plan you can review, edit, and approve before any code is written. Use it for larger or riskier changes where you want to see and shape the approach first.","keywords":["brainstorm in plan mode","plan before building","implementation plan","detailed spec for complex builds"],"href":"/features/plan-mode"},{"title":"Implement changes in Build mode","sidebarTitle":"Build mode","description":"Build mode lets Lovable implement and verify changes directly in your project, handling execution end to end with minimal supervision.","href":"/features/agent-mode"},{"title":"Set a goal for Lovable","sidebarTitle":"Goals","description":"Type /goal in a Build mode message, or pick Goal from the Skills list, to set that message as a goal. Lovable works on it until the goal is achieved, so a large task can be finished completely in a single message.","href":"/features/goal-runs"},{"title":"Subagents","sidebarTitle":"Subagents","description":"Subagents help Lovable investigate complex tasks faster by splitting research, code exploration, and review into focused investigations.","keywords":["subagents","parallel agents","explore","background agents","read-only agents"],"href":"/features/subagents"}]},{"group":"Context \u0026 instructions","pages":[{"title":"Instructions","sidebarTitle":"Instructions","description":"Define persistent instructions for Lovable at workspace, project, and personal level: coding standards, architecture rules, and context Lovable applies on every message.","keywords":["workspace knowledge","project knowledge","personal knowledge","user instructions","knowledge","custom knowledge","custom instructions","coding standards","agent context","persistent instructions","AGENTS.md","CLAUDE.md"],"href":"/features/knowledge"},{"title":"Memory: what Lovable remembers as you build","sidebarTitle":"Memory","description":"Lovable saves the preferences, decisions, and facts you state while you build, and applies them in later conversations without you repeating them.","keywords":["memories","dreams","memory cleanup","memory consolidation","outdated memory","agent memory","what Lovable knows about me","turn off memory","delete memory","keeps forgetting","repeats itself","stop suggesting the same thing"],"href":"/features/memory"},{"title":"Define reusable instructions with skills","sidebarTitle":"Skills","description":"Define reusable, on-demand workflows for Lovable with workspace skills and your own personal skills: named playbooks Lovable applies when a matching task comes up.","keywords":["skills","workspace skills","private skills","my skills","playbooks","reusable instructions","launch checklist","release notes","agent workflows","on-demand instructions","custom instructions"],"href":"/features/skills"},{"title":"Cross-project referencing","description":"Reuse implementations across projects in your workspace, including code, assets, files, and chat history. Maintain consistency and avoid rebuilding the same features.","keywords":["cross-project referencing","reuse across projects","reuse code across projects","reference another project","workspace knowledge reuse","share implementations between projects","@ mention projects","access other projects","reuse components across projects"],"href":"/features/cross-project-referencing"}]},{"title":"Generate files and analyze data","sidebarTitle":"File generation","description":"Analyze data, generate files, and build from the results directly in the project chat.","keywords":["file generation","data analysis","CSV export","PDF report","Excel export","data transformation","chart generation","report automation","code execution","slide deck","pitch deck","presentation","PPTX","image editing"],"href":"/features/generate-files"},{"group":"Design","pages":[{"title":"Edit from the preview","sidebarTitle":"Preview toolbar","description":"Use the preview toolbar to select elements, edit text inline, draw annotations, and leave comments directly on your app preview while you build.","keywords":["preview toolbar","visual edits","select element","edit text inline","draw annotation","comments","preview","design panel","formatting panel","edit styles","keyboard shortcuts"],"href":"/features/preview-toolbar"},{"title":"Design guidance","description":"Answer Lovable's design questions about color, typography, and layout before it builds, so the first version matches the look you want.","keywords":["design questions","design guidance","design directions","typography","color palette","layout","visual identity","font pairs"],"href":"/features/design-guidance"},{"title":"Design templates","description":"Reuse Lovable projects as design templates. Templates copy the full codebase, including design, components, and structure, to maintain consistency and accelerate development.","keywords":["design templates","project templates","reusable project templates","Lovable design templates","workspace templates","default templates"],"href":"/features/business/design-templates"},{"title":"Design systems","description":"Create reusable design systems in Lovable to standardize React component libraries, styling guidelines, and setup across projects.","keywords":["design system","ui components","component library","reusable components","ui kit","design guidelines"],"href":"/features/design-systems"},{"title":"Use custom fonts","sidebarTitle":"Custom fonts","description":"Apply web-safe fonts like Arial or Courier New, or use any Google Font by name or link to customize your project's typography.","keywords":["custom fonts","google fonts","web-safe fonts","typography","change font","font upload","playfair display","brand font"],"href":"/tips-tricks/custom-fonts"},{"title":"Use 21st.dev components in Lovable","sidebarTitle":"21st.dev","description":"Copy pre-built hero sections, navigation bars, testimonials, and other UI components from 21st.dev directly into your projects.","keywords":["21st.dev","ui components","component library","hero section","copy prompt","pre-built components","shadcn components"],"href":"/tips-tricks/21stdev"},{"title":"Bring Figma designs into Lovable","sidebarTitle":"Figma","description":"Three ways to import Figma designs, tokens, and components into Lovable: use the Figma plugin, connect via Figma MCP, or upload a .fig file.","keywords":["Figma","Figma import","Figma plugin","Figma MCP","design tokens","design import","fig file","figma variables","figma to lovable"],"href":"/integrations/figma"}]},{"group":"Backend","root":{"title":"Built-in backend","sidebarTitle":"Overview","description":"Lovable hosts your app and includes a built-in backend with database, authentication, storage, edge functions, and AI, no infrastructure setup required.","keywords":["lovable cloud","cloud","backend","hosting","database","authentication","storage","edge functions","enable cloud"],"href":"/features/cloud"},"pages":[{"group":"Database","root":{"title":"Database","description":"View and edit your app's data in the Database view: browse tables, edit records, run SQL, change your data structure, and open the tools around your database.","keywords":["postgres database","view my data","data table","import csv","supabase migrations","lovable cloud database","sql editor","where is my data","contact form","where do form submissions go","lead capture"],"href":"/features/database"},"pages":[{"title":"Control who can access your app's data","sidebarTitle":"Access and security","description":"Review the row level security policies that decide which rows each user can see or change, ask Lovable to change one, and rotate your database password.","keywords":["rls","access rules","database policies","row level security","rotate password","database password","who can see my data","data leak","private data","anon key","service role key"],"href":"/features/database-access"},{"title":"Fix a slow database and choose the right capacity","sidebarTitle":"Performance and capacity","description":"Read the high-load notices Lovable shows, find the slow queries behind them, and decide whether your database needs a larger instance or more storage.","keywords":["advanced settings","upgrade instance","resource pressure","instance upgrade recommended","app is slow","slow database","disk space","bigger database","database running out of resources","cpu memory disk"],"href":"/features/database-performance"},{"title":"Back up, restore, and export your project's database","sidebarTitle":"Backups and export","description":"Restore your app's database from a daily backup, export a full copy of it, and learn what backups and exports include before you move your backend elsewhere.","keywords":["point in time recovery","pitr","cloud backups","export lovable cloud data","migrate database","download my database","lost data","roll back database","database copy"],"href":"/features/database-backups"},{"title":"Pause, resume, or remove your project's database","sidebarTitle":"Pause, resume, and remove","description":"Pause a project's database to save credits, wake it up again from the paused card, and learn what removing the database deletes before you do it.","keywords":["pause cloud","remove cloud","remove lovable cloud","wake up project","paused project","stop charges","delete database","project paused"],"href":"/features/database-pause-remove"}]},{"group":"Users \u0026 authentication","root":{"title":"Users and authentication","description":"Manage your app's users and configure how they sign in: email, phone, Google, Apple, Microsoft, Lovable, SAML SSO, and OIDC, all part of the built-in backend.","sidebarTitle":"Users \u0026 authentication","keywords":["authentication","users","sign in","login","auth settings","google sign in","apple sign in","microsoft sign in","sign in with lovable","saml sso","oidc","openid connect","invite user","cloud auth","jwt","session timeout","token expiry","log out","oauth provider","migrate users"],"href":"/features/authentication"},"pages":[{"title":"Email authentication for your app","sidebarTitle":"Email auth","description":"Configure email sign-in for your app's built-in backend: confirmation, password rules, one-time codes, and sending limits.","keywords":["email authentication","email sign-in","password rules","email confirmation","auto-confirm","email otp","magic link","have i been pwned","signup settings"],"href":"/features/email-auth"},{"title":"Phone authentication for your app","sidebarTitle":"Phone auth","description":"Let users sign in to your app with their phone number and an SMS one-time code, using your own SMS provider.","keywords":["phone authentication","phone sign-in","sms otp","twilio","vonage","messagebird","textlocal","sms sign in","phone number login"],"href":"/features/phone-auth"},{"title":"Add Google authentication to your app","sidebarTitle":"Google auth","description":"Add Sign in with Google to your app, managed by Lovable with no setup or with your own Google Cloud OAuth credentials and consent screen.","keywords":["google authentication","google auth","google sign-in","sign in with google","google oauth 2.0","lovable cloud authentication","managed oauth","bring your own credentials","BYOK","oauth consent screen","oauth redirect urls"],"href":"/features/google-auth"},{"title":"Add Apple authentication to your app","sidebarTitle":"Apple auth","description":"Add Sign in with Apple to your app using managed Apple OAuth or your own Apple Developer credentials.","keywords":["apple authentication","apple auth","sign in with apple","apple oauth","services id","apple developer","jwt client secret","hide my email","apple login lovable"],"href":"/features/apple-auth"},{"title":"Add Microsoft authentication to your app","sidebarTitle":"Microsoft auth","description":"Add Microsoft sign-in to your app using managed Microsoft OAuth or your own Azure app registration.","keywords":["microsoft authentication","microsoft auth","microsoft sign in","microsoft login","azure ad","entra id","microsoft oauth","tenant id","azure app registration","microsoft login lovable"],"href":"/features/microsoft-auth"},{"title":"Add Sign in with Lovable to your app","sidebarTitle":"Lovable auth","description":"Let your app's users sign in with their Lovable account. Lovable registers and maintains the OAuth credentials for your project, so there is nothing to configure.","keywords":["lovable authentication","lovable auth","sign in with lovable","continue with lovable","lovable account login","lovable oauth provider","lovable login button","social login lovable"],"href":"/features/lovable-auth"},{"title":"Add SAML single sign-on to your app","sidebarTitle":"SAML SSO (apps)","description":"Let end users of your app sign in with their company identity provider, such as Okta, Microsoft Entra ID, Google Workspace, or any SAML 2.0 IdP.","keywords":["SAML SSO","SAML 2.0","Cloud SAML","end user SSO","app SSO","enterprise login","Okta","Microsoft Entra ID","Google Workspace SAML","OneLogin","JumpCloud","ACS URL","Audience URI","SP Entity ID","SAML metadata URL","JIT provisioning"],"href":"/features/saml-sso"},{"title":"Add OpenID Connect (OIDC) sign-in to your app","sidebarTitle":"OIDC sign-in (apps)","description":"Let your app's users sign in with your own OpenID Connect provider, such as Auth0, Okta, Microsoft Entra ID, or Keycloak, on the built-in backend (Cloud).","keywords":["OIDC","OpenID Connect","OIDC sign-in","app SSO","end user SSO","Auth0","Okta","Entra ID","Keycloak","Cognito","issuer URL","client ID","client secret","redirect URI","custom OIDC provider"],"href":"/features/oidc-auth"},{"title":"Reuse Lovable workspace identity in your app","sidebarTitle":"Workspace identity (apps)","description":"Let apps you build for your team recognize the logged-in Lovable user automatically, without a separate login flow.","keywords":["Lovable workspace identity","workspace identity reuse","ambient identity","internal tools","workspace apps","app login methods","logged-in Lovable user"],"href":"/features/lovable-workspace-identity-reuse"}]},{"title":"Storage","description":"Store and manage your app's files in the built-in backend: create buckets, upload and organize files, and control public access.","keywords":["storage","buckets","file upload","public bucket","private bucket","signed url","file storage","cloud storage"],"href":"/features/storage"},{"title":"Secrets","description":"Store API keys and other sensitive values securely in your app's built-in backend, and understand the difference between secrets and VITE_ environment variables.","keywords":["secrets","api keys","environment variables","credentials","LOVABLE_API_KEY","VITE_"],"href":"/features/secrets"},{"title":"Jobs","description":"Review the scheduled background jobs in your app's built-in backend, check their run history, and enable or disable them.","keywords":["jobs","cron","background tasks","recurring work","cron secret","secure cron job"],"href":"/features/jobs"},{"title":"Edge functions","description":"Run serverless backend code in your app, part of the built-in backend, and monitor invocations, success rates, and logs.","keywords":["edge functions","serverless","backend code","invocations","function logs","server functions","cloud functions"],"href":"/features/edge-functions"},{"title":"Logs","description":"Debug errors and track activity in your app with searchable built-in backend logs across functions, database, auth, and storage.","keywords":["logs","debugging","edge logs","function logs","postgres logs","auth logs","monitoring"],"href":"/features/logs"},{"title":"Project usage and costs","sidebarTitle":"Usage","description":"See what drives your project's run credit usage across hosting and the built-in backend (Cloud), and how monthly grants work.","keywords":["project usage","cloud usage","run credits","cloud costs","usage breakdown","monthly grants","credit usage"],"href":"/features/project-usage"}]},{"group":"AI for your app","root":{"title":"AI features for your app","description":"Add AI features such as chatbots, summaries, and image generation to your Lovable app with the built-in AI connector. No API keys or provider setup required.","sidebarTitle":"AI for your app","keywords":["lovable ai","ai apps","ai-powered apps","add ai to my app","ai chatbot","built-in ai connector","supported ai models","ai gateway","ai features","ai app context","ai grant","lovable api key"],"href":"/features/ai"},"pages":[{"title":"Add chatbots and text generation to your app","sidebarTitle":"Chat and text","description":"Pick a chat model for chatbots, summaries, and document questions in your app, show the model's thinking as it answers, and ask for priority processing.","keywords":["chatbot model","assistant model","openai gpt","gemini","claude","anthropic","chat latest","reasoning model","thinking","priority processing","summarize text","sentiment analysis"],"href":"/features/ai-chat"},{"title":"Let users generate and edit images in your app","sidebarTitle":"Images","description":"Add image generation and editing to your app. For detailed edits, fast previews, and short animated GIFs.","keywords":["image generation","edit an image","image editing","nano banana","gpt image","transparent background","mask an image","product mockups","thumbnails"],"href":"/features/ai-images"},{"title":"Let users generate and edit videos in your app","sidebarTitle":"Video","description":"Add video to your app: the models and how they differ, starting from your own images, editing and extending a clip, restoring old footage, and what video costs.","keywords":["video generation","veo","gemini omni","animate a photo","video clip","extend a video","4k video","vertical video","reference photos","upscale a video","improve video quality","blurry video"],"href":"/features/ai-video"},{"title":"Let users create music in your app","sidebarTitle":"Music","description":"Add music generation to your app: the two models, how to describe a track in the prompt, how long a finished track stays available, and what a track costs.","keywords":["music generation","lyria","soundtrack","jingle","instrumental","background music","generate a song","lyrics"],"href":"/features/ai-music"},{"title":"Help users find relevant content in your app","sidebarTitle":"Search by meaning","description":"Add semantic search, retrieval-augmented generation (RAG), and knowledge bases to your app with embedding models, and see which model fits which workload.","keywords":["semantic search","embeddings","rag","retrieval augmented generation","knowledge base","vector search","faq bot","document search"],"href":"/features/ai-search"},{"title":"Automate classification, routing, and scoring in your app","sidebarTitle":"Classify and score","description":"Use typed decision models to turn text your app already has into a category, a score, or a yes/no probability it can act on in code, instead of generated prose.","keywords":["typed decision","jev","typesafe","classification","routing","scoring","ranking","ticket triage","content moderation"],"href":"/features/ai-decisions"},{"title":"Let users listen to your app's content","sidebarTitle":"Text to speech","description":"Add spoken audio to your app with text-to-speech models: read articles aloud, narrate generated text, and describe the tone or pacing you want.","keywords":["text to speech","read aloud","narration","voice over","audiobook","tts","speak text","spoken audio"],"href":"/features/ai-text-to-speech"},{"title":"Add transcription and voice input to your app","sidebarTitle":"Speech to text","description":"Turn recordings, voice notes, and spoken input into text with speech-to-text models, including the file size each model accepts and how to split long audio.","keywords":["speech to text","transcribe audio","transcription","dictation","captions","subtitles","voice input","meeting notes"],"href":"/features/ai-speech-to-text"},{"title":"Build voice assistants your users can talk to","sidebarTitle":"Live voice","description":"Add a two-way spoken conversation to your app: people talk and interrupt, your backend does work during the call, and your app speaks the result back.","keywords":["live voice","voice assistant","gpt live","realtime voice","voice conversation","talk to my app","voice agent","voice tutor"],"href":"/features/ai-live-voice"},{"title":"Replace deprecated AI models in your app","sidebarTitle":"Deprecated models","description":"Check which AI models are being retired, what happens to your app's requests after the retirement date, and how to move your app to a current model.","keywords":["deprecated ai models","model retirement","retired model","model sunset","migrate model","model replaced","gpt-5 retirement","gemini 2.5 retirement","switch ai model","my app uses an old model"],"href":"/features/ai-deprecated-models"}]},{"group":"Test your app","pages":[{"title":"Test and verify your app","sidebarTitle":"Testing tools","description":"Lovable provides browser testing, frontend tests, and edge function verification to help understand system behavior, validate user workflows, and ensure backend logic works as expected.","href":"/features/testing"},{"title":"Test your app in a browser","sidebarTitle":"Browser testing","description":"Learn how Lovable uses browser testing to verify your app by clicking buttons, filling forms, testing flows, and checking behavior across screen sizes.","keywords":["browser testing","lovable browser testing","test app behavior","verify app features","ui testing","end to end testing","test user flows","mobile testing","preview testing"],"href":"/features/browser-testing"}]},{"group":"Secure your app","root":{"title":"Security overview","description":"Protect your apps with built-in security scans, API key protection, database access checks, dependency audits, and optional security integrations.","keywords":["security","quick scan","deep scan","basic scan","api key protection","secrets","row level security","rls","security scanning","dependency audit","vulnerability scanning"],"href":"/features/security"},"pages":[{"title":"Project security view","sidebarTitle":"Project security view","description":"Review scan results, fix vulnerabilities, and manage dependency risks for a single project before and after publishing.","keywords":["project security","security view","security scanning","quick scan","deep scan","basic scan","security findings","row level security","database security","code security review","dependency audit","vulnerability scanning","ignore security finding","sbom export","export dependencies","spdx json","cyclonedx bom"],"href":"/features/security-view"},{"title":"Trust center","description":"Share security checks verified by Lovable for your published app, with a page at /.well-known/trust.html and machine-readable results at /.well-known/trust.json.","keywords":["trust center","trust page","trust.json","SBOM","software bill of materials","security page","vendor review","security questionnaire","security posture","due diligence","well-known","is my app secure"],"href":"/features/trust-center"},{"title":"Security best practices for Lovable apps","sidebarTitle":"Security best practices","description":"Secure coding best practices for Lovable apps, including frontend security, Edge Functions, row-level security (RLS), authentication, and workspace protection.","keywords":["Lovable security","security best practices","secure coding","Edge Functions security","row-level security","RLS best practices","frontend security"],"href":"/tips-tricks/security-best-practices"}]},{"title":"Using npm packages","sidebarTitle":"npm packages","description":"Add drag-and-drop, charts, animations, and other advanced features by asking Lovable to integrate npm packages into your project.","keywords":["npm packages","install npm package","javascript libraries","dependencies","bun","third-party packages"],"href":"/tips-tricks/npm-packages"},{"title":"Build secrets","description":"Store encrypted, workspace-level environment variables that Lovable injects when your projects build, for example npm tokens for installing private packages.","tag":"ENT","keywords":["build secrets","environment variables","npm token","private npm packages","npmrc","registry token","build-time secrets","workspace secrets","private packages","design system token"],"href":"/features/build-secrets"},{"title":"Managed registry","description":"Set up a managed npm registry inside your Lovable workspace to publish and install packages without exposing them publicly.","tag":"ENT","keywords":["managed registry","npm registry","private npm","private packages","npm packages","package registry","internal packages","enterprise npm"],"href":"/features/managed-registry"}]},{"group":"Connect","icon":"plug","pages":[{"group":"Connectors","root":{"title":"Lovable connectors: Connect tools, services, and APIs","sidebarTitle":"Overview","description":"Connect Lovable to external tools, services, and APIs. Choose between app + chat connectors, chat connectors, and app user connectors, or integrate any API.","keywords":["Lovable integrations","Lovable connectors","MCP servers","app + chat connectors","chat connectors","app user connectors","custom MCP servers","Lovable API integrations","integrate external APIs","connect external services"],"href":"/integrations/introduction"},"pages":[{"title":"App + chat connectors: Add capabilities to your published app and your chat","sidebarTitle":"App + chat connectors","description":"Connect a tool like Slack, HubSpot, or Google Sheets once and use it everywhere: Lovable works with it while you build, and your published app uses it to send messages, read data, and take actions for your users.","keywords":["app + chat connectors","app + chat connector","shared connection","connector gateway","LOVABLE_API_KEY","connector approval","connection","workspace connectors","link connection to project","unlink connection","delete connection"],"href":"/integrations/app-connectors"},{"title":"App user connectors: let your users connect their own accounts","sidebarTitle":"App user connectors","description":"App user connectors let each end user of your published Lovable app connect their own third-party account, so your app acts on their behalf with their own permissions. Authentication is handled securely through Lovable's connector gateway.","keywords":["app user connector","app user connectors","per-user connector","end user authentication","OAuth on behalf of user","connector gateway","multi-tenant","connect your own account","app user client","redirect URI","domain verification","authorized domains","background access","scheduled sync","logged out users"],"href":"/integrations/app-user-connectors"},{"title":"Create a custom connector","sidebarTitle":"Custom connectors","description":"Build your own connector for any REST API, public or internal, and make it available to your Lovable workspace. Define the endpoint, authentication, and knowledge once, and let everyone in your workspace connect to it like any other app connector.","keywords":["create a connector","custom connector","custom connectors","connector knowledge files","User Defined Connectors","UDC","custom API connector","Lovable custom integration","connect your own API","internal API connector","REST API connector","OAuth connector","API key connector","workspace connectors"],"href":"/integrations/create-connector"},{"title":"Chat connectors: Connect your tools to Lovable using MCP servers","sidebarTitle":"Chat connectors","description":"Connect your own tool accounts to Lovable as chat connectors (MCP servers). Lovable reads real context from tools like Notion, Linear, Jira, or Miro while you build, so results match your actual work.","keywords":["Lovable integrations","Lovable connections","MCP server","chat connectors","Model Context Protocol","MCP connector","AI workspace automation","Notion","Linear","Loom","Jira","Confluence","Atlassian","Miro","n8n","Sanity","Hex","HeyGen","PostHog","Sentry","Supermetrics","Confidence","Excalidraw","Wispr Flow","Canva","custom MCP server","AI tools for productivity"],"href":"/integrations/chat-connectors"},{"title":"Connect a custom MCP server as a chat connector","sidebarTitle":"Custom MCP servers","description":"Connect any remote MCP server to Lovable as a chat connector. Bring internal tools, private APIs, and custom data sources into the project chat and Chats as live context.","keywords":["custom MCP server","MCP server","Model Context Protocol","remote MCP","chat connector","internal tools","private API","bearer token","OAuth MCP","add MCP server","Lovable static IPs","static IP","egress IP ranges","firewalled MCP server","on-prem MCP server"],"href":"/integrations/custom-mcp"},{"title":"MCP registries","description":"Add an MCP registry to your workspace so members can browse a directory of MCP servers and connect them as chat connectors without pasting URLs.","keywords":["mcp registry","mcp registries","mcp server directory","browse mcp servers","connect mcp server","mcp registry url","internal mcp registry"],"href":"/integrations/mcp-registries"},{"title":"Manage connectors in your workspace","sidebarTitle":"Admin controls","description":"Workspace admins control who can create connections and clients for each connector, which is also how connectors are made available or disabled. Learn the defaults per plan and every governance setting.","keywords":["connector admin settings","who can create connections","who can manage connections","disable connector","connector availability","connector governance","MCP admin","chat connector admin","workspace connector settings","connection access"],"href":"/integrations/admin-controls"},{"title":"Connector activity: see and fix failed connector requests","sidebarTitle":"Connector activity","description":"See the requests your Lovable app and project chat send through a connector, with the status and duration of each, and ask Lovable to fix one that failed.","keywords":["connector logs","connector activity","connector errors","connector request failed","debug connector","connection not working","api call failed","request log","response time","fix with lovable","connector troubleshooting"],"href":"/integrations/connector-activity"},{"title":"Integration security","description":"How Lovable stores and protects integration credentials, plus the gateway, IP allowlisting, and domain restrictions that secure connector traffic.","keywords":["integration security","credentials","credential storage","rotation","data retention","domain restrictions","ip allowlist","ip whitelist","gateway","connector security"],"href":"/integrations/security"}]},{"group":"Connector catalog","pages":[{"group":"AI \u0026 search","pages":[{"title":"Connect your app to Algolia","sidebarTitle":"Algolia","description":"Connect your app to Algolia, a hosted search and indexing engine, to add full-text search, faceted filtering, and indexing to your Lovable app.","keywords":["algolia","search","indexing","full-text search","faceted search","search engine","autocomplete","instant search"],"href":"/integrations/algolia"},{"title":"Connect your app to Apify","sidebarTitle":"Apify","description":"Connect your app to Apify, a web scraping and automation platform, to run Actors and read datasets from your Lovable app.","keywords":["apify","web scraping","actors","datasets","crawler","automation","apify api"],"href":"/integrations/apify"},{"title":"Connect ElevenLabs to enable voice AI in your app","sidebarTitle":"ElevenLabs","description":"Connect your app to ElevenLabs, an AI audio platform, to generate speech, transcribe audio, create music and sound effects, and build voice agents.","keywords":["elevenlabs","text-to-speech","voice","speech-to-text","transcription","voice agents","sound effects","ai audio"],"href":"/integrations/eleven-labs"},{"title":"Connect Firecrawl to scrape web data for your app","sidebarTitle":"Firecrawl","description":"Connect your app to Firecrawl, a web scraping and crawling platform, to scrape pages, crawl sites, and extract structured data from websites.","keywords":["firecrawl","web scraping","crawler","scraper","website data","structured extraction","markdown","site crawl"],"href":"/integrations/firecrawl"},{"title":"Connect your app to Fireworks AI","sidebarTitle":"Fireworks AI","description":"Connect your app to Fireworks AI, an inference platform for open models, to run text generation, image generation, embeddings, and fine-tuning from your Lovable app.","keywords":["fireworks ai","inference","open models","text generation","image generation","embeddings","fine-tuning","llama"],"href":"/integrations/fireworks"},{"title":"Connect your app to Gemini Enterprise","sidebarTitle":"Gemini Enterprise","description":"Connect your app to Gemini Enterprise, Google Cloud's enterprise search platform, to search connected data stores and show grounded answers with citations.","keywords":["gemini enterprise","vertex ai search","discovery engine","enterprise search","grounded answers","google cloud","citations","knowledge assistant"],"href":"/integrations/gemini-enterprise"},{"title":"Connect your app to LlamaParse Platform","sidebarTitle":"LlamaParse Platform","description":"Connect your app to LlamaParse, LlamaIndex's document parsing and extraction platform, to parse documents, extract structured data, and search your document indexes from your Lovable app. Use Lovable's managed connection for parsing and extraction, or your own LlamaParse API key for the full LlamaParse API.","keywords":["llamacloud","llamaindex","llamaparse","llamaextract","document parsing","rag","retrieval","extraction","managed by lovable"],"href":"/integrations/llamaparse"},{"title":"Connect your app to Parallel","sidebarTitle":"Parallel","description":"Connect your app to Parallel, a web search and research API, to search the web, read pages, and run deep research with cited sources.","keywords":["parallel","web search","deep research","lead enrichment","web extraction","competitor analysis","fact checking"],"href":"/integrations/parallel"},{"title":"Connect your app to Perplexity","sidebarTitle":"Perplexity","description":"Connect your app to Perplexity, an AI search and answer engine, to return cited answers from live web, academic, and financial sources. Use Lovable's managed connection for web search, or your own API key for the full Perplexity API.","keywords":["perplexity","ai search","sonar","citations","web search","deep research","managed by lovable","search api"],"href":"/integrations/perplexity"},{"title":"Connect your app to Replicate","sidebarTitle":"Replicate","description":"Connect your app to Replicate, a platform for running open-source AI models, to generate images, video, audio, and text from your Lovable app.","keywords":["replicate","ai models","image generation","video generation","audio generation","flux","stable diffusion","whisper"],"href":"/integrations/replicate"}]},{"group":"Data \u0026 databases","pages":[{"title":"Connect to Supabase","sidebarTitle":"Supabase","description":"Connect Lovable with Supabase for seamless backend setup, database, auth, storage, real-time, and serverless functions.","href":"/integrations/supabase"},{"title":"Connect your app to Amazon Redshift","sidebarTitle":"Amazon Redshift","description":"Connect your app to Amazon Redshift, a cloud data warehouse, to run SQL queries and read results from your warehouse in your Lovable app.","keywords":["amazon redshift","redshift","sql","data warehouse","analytics","redshift data api","serverless","amazon"],"href":"/integrations/amazon-redshift"},{"title":"Connect your app to AWS Athena","sidebarTitle":"AWS Athena","description":"Connect your app to AWS Athena, the serverless SQL query service for data in Amazon S3, to run queries and power dashboards from your data lake.","keywords":["aws athena","athena","sql","data lake","s3","analytics","serverless query","amazon"],"href":"/integrations/aws-athena"},{"title":"Connect your app to AWS S3","sidebarTitle":"AWS S3","description":"Connect your app to AWS S3 to read and write CSV, JSON, Parquet, and other data files in S3 buckets from your Lovable apps.","keywords":["AWS S3 integration","S3 connector","AWS S3 bucket","S3 files","CSV","JSON","Parquet","cloud storage","Amazon S3","data files","Lovable S3 integration"],"href":"/integrations/aws-s3"},{"title":"Connect your app to BigQuery","sidebarTitle":"BigQuery","description":"Connect Google BigQuery to your Lovable app by signing in with Google (OAuth) or using Workload Identity Federation. Run SQL, explore datasets and schemas, and build analytics features without storing long-lived GCP keys in your project.","keywords":["BigQuery","Google BigQuery","GCP","Google Cloud","SQL","data warehouse","analytics","Workload Identity Federation","WIF","Lovable BigQuery"],"href":"/integrations/bigquery"},{"title":"Connect your app to ClickHouse","sidebarTitle":"ClickHouse","description":"Connect a ClickHouse database to your Lovable app over the HTTP interface. Run SQL queries, explore schemas, and build analytics features against self-hosted or ClickHouse Cloud databases.","keywords":["ClickHouse","ClickHouse Cloud","ClickHouse connector","OLAP","analytics","SQL","HTTP interface","Lovable ClickHouse"],"href":"/integrations/clickhouse"},{"title":"Connect your app to Cube","sidebarTitle":"Cube","description":"Connect your app to Cube to build dashboards and reports on the business metrics that your data team already defines.","keywords":["cube","cube cloud","cube core","cubejs","cube.js","semantic layer","metrics layer","headless bi"],"href":"/integrations/cube"},{"title":"Connect your app to Databricks","sidebarTitle":"Databricks","description":"Connect your app to Databricks to query warehouse data, build live dashboards, and power data-driven tools using your existing tables and views. Connect with a service principal or sign in with your own Databricks account.","keywords":["Databricks integration","Databricks connector","Databricks SQL","Databricks warehouse","Databricks dashboard","Lovable Databricks","data warehouse integration","lakehouse","service principal","Unity Catalog","OAuth","user OAuth","U2M","M2M","custom OAuth application"],"href":"/integrations/databricks"},{"title":"Connect your app to the dbt Semantic Layer","sidebarTitle":"dbt Semantic Layer","description":"Connect your app to the dbt Semantic Layer to query governed metrics defined in dbt, sliced by dimensions and time, without writing warehouse SQL.","keywords":["dbt","semantic layer","metrics","metricflow","governed metrics","analytics","dbt Cloud"],"href":"/integrations/dbt-semantic-layer"},{"title":"Connect your app to GoodData","sidebarTitle":"GoodData","description":"Connect your app to GoodData Cloud to browse your workspaces, metrics, and visualizations and run analytics queries from your Lovable app.","keywords":["gooddata","gooddata cloud","business intelligence","semantic layer","metrics","analytical dashboards","analytics","lovable gooddata"],"href":"/integrations/gooddata"},{"title":"Connect your app to IBM Db2","sidebarTitle":"IBM Db2","description":"Connect your app to IBM Db2 on Cloud to browse your schemas and tables and run SQL queries from your Lovable app.","keywords":["ibm db2","db2 on cloud","db2 rest api","sql queries","lovable db2"],"href":"/integrations/ibm-db2"},{"title":"Connect your app to Looker","sidebarTitle":"Looker","description":"Connect your app to Looker to build dashboards and reporting tools using the metric definitions your analytics team maintains in LookML.","keywords":["looker","lookml","semantic model","explores","governed metrics","looker dashboards","lovable looker"],"href":"/integrations/looker"},{"title":"Connect your app to Metabase","sidebarTitle":"Metabase","description":"Connect your app to Metabase to run your team's saved questions and custom queries and show the results in your Lovable app.","keywords":["metabase","business intelligence","saved questions","dashboards","sql queries","metabase cloud","lovable metabase"],"href":"/integrations/metabase"},{"title":"Connect your app to Microsoft Fabric","sidebarTitle":"Microsoft Fabric","description":"Connect your app to Microsoft Fabric to query Lakehouses, Warehouses, SQL databases, and mirrored databases through Fabric's API for GraphQL.","keywords":["microsoft fabric","lakehouse","warehouse","graphql","azure","analytics","mirrored database"],"href":"/integrations/microsoft-fabric"},{"title":"Connect your app to MotherDuck","sidebarTitle":"MotherDuck","description":"Connect your app to MotherDuck, the cloud service for DuckDB, to query your data with SQL and build dashboards and reports in your Lovable app.","keywords":["motherduck","duckdb","duckdb cloud","sql analytics","data warehouse","parquet","dashboard from sql"],"href":"/integrations/motherduck"},{"title":"Connect your app to Neon","sidebarTitle":"Neon","description":"Connect your app to Neon, a serverless Postgres platform, to read and write your own Neon database from your Lovable app.","keywords":["neon","neon postgres","serverless postgres","postgres database","sql queries","database branching","neon connector"],"href":"/integrations/neon"},{"title":"Connect your app to Omni","sidebarTitle":"Omni","description":"Connect your app to Omni, a business intelligence platform, to build dashboards and reports on the metrics your data team defines in Omni.","keywords":["omni analytics","omni","semantic layer","metrics","topics","bi dashboards","lovable omni"],"href":"/integrations/omni"},{"title":"Connect your app to Oracle Autonomous AI Database","sidebarTitle":"Oracle Autonomous AI Database","description":"Connect your Lovable app to Oracle Autonomous AI Database to run SQL queries, explore schemas, and build dashboards and reports on your Oracle data.","keywords":["oracle autonomous ai database","oracle autonomous database","autonomous ai lakehouse","autonomous data warehouse","oracle fusion data intelligence","ords","rest-enabled sql","lovable oracle"],"href":"/integrations/oracle-autonomous"},{"title":"Connect your app to Power BI","sidebarTitle":"Power BI","description":"Connect your app to Power BI to query the semantic models behind your reports, or rebuild an existing report in your Lovable app with the same numbers.","keywords":["power bi","semantic model","dataset","dax","measures","row-level security","fabric","lovable power bi","migrate power bi report","recreate power bi report"],"href":"/integrations/power-bi"},{"title":"Connect your app to Qlik Cloud","sidebarTitle":"Qlik Cloud","description":"Connect your app to Qlik Cloud to browse your Qlik Sense apps, export report data, ask Insight Advisor questions, and trigger reloads from your Lovable app.","keywords":["qlik cloud","qlik sense","qlik connector","business intelligence","report export","insight advisor","app reload","lovable qlik"],"href":"/integrations/qlik-cloud"},{"title":"Connect your app to Snowflake","sidebarTitle":"Snowflake","description":"Connect Snowflake to your Lovable app using Snowflake OAuth. Run SQL, use the SQL REST API, and work with warehouses and data from your Snowflake account through Lovable's connector gateway.","keywords":["Snowflake","Snowflake connector","SQL","data warehouse","OAuth","security integration","analytics","semantic views","semantic layer","Lovable Snowflake"],"href":"/integrations/snowflake"}]},{"group":"Communication \u0026 messaging","pages":[{"title":"Connect your app to Brevo","sidebarTitle":"Brevo","description":"Connect your app to Brevo to send transactional and marketing emails, manage contacts and lists, and trigger communication workflows from your Lovable app.","keywords":["brevo","sendinblue","email api","transactional email","marketing email","contacts","sms","marketing automation"],"href":"/integrations/brevo"},{"title":"Connect your app to Discord","sidebarTitle":"Discord","description":"Connect your app to Discord to post channel messages, list the servers a bot is in, and read recent channel history.","keywords":["discord","discord bot","bot token","discord messages","discord notifications","discord servers","slash commands"],"href":"/integrations/discord"},{"title":"Connect your app to Firebase Cloud Messaging","sidebarTitle":"Firebase Cloud Messaging","description":"Connect your app to Firebase Cloud Messaging to send push notifications to devices and topics from your Lovable app.","keywords":["firebase cloud messaging","fcm","push notifications","web push","topic messaging","firebase","device notifications"],"href":"/integrations/firebase-cloud-messaging"},{"title":"Connect your app to GatewayAPI","sidebarTitle":"GatewayAPI","description":"Connect your app to GatewayAPI, an SMS and RCS messaging API, to send mobile messages, track delivery status, and handle inbound replies from your Lovable app.","keywords":["gatewayapi","sms","rcs","messaging","mobile messaging","delivery status","webhooks","notifications"],"href":"/integrations/gatewayapi"},{"title":"Connect your app to Intercom","sidebarTitle":"Intercom","description":"Connect your app to Intercom, the customer messaging platform, to search and reply to conversations, manage contacts and tickets, and read help center articles.","keywords":["intercom","help desk","live chat","support tickets","inbox","help center","customer support"],"href":"/integrations/intercom"},{"title":"Connect your app to Mailchimp Transactional","sidebarTitle":"Mailchimp Transactional","description":"Connect your app to Mailchimp Transactional to send personalized email, use your email templates, and track delivery activity from your Lovable app.","keywords":["mailchimp transactional","mandrill","order confirmations","appointment reminders","email delivery tracking","transactional email templates"],"href":"/integrations/mailchimp-transactional"},{"title":"Connect your app to Mailgun","sidebarTitle":"Mailgun","description":"Connect your app to Mailgun to send transactional email, manage sending domains, and track delivery events from your Lovable app.","keywords":["mailgun","transactional email","email api","sending domain","dkim","spf","bounces","deliverability","mailgun api key"],"href":"/integrations/mailgun"},{"title":"Connect your app to Mailjet","sidebarTitle":"Mailjet","description":"Connect your app to Mailjet, an email delivery service, to send transactional email, manage contact lists, and track message delivery from your Lovable app.","keywords":["mailjet","transactional email","email api","contact lists","newsletter","email delivery","sender validation"],"href":"/integrations/mailjet"},{"title":"Connect your app to Resend","sidebarTitle":"Resend","description":"Connect your app to Resend, an email API, to send transactional emails and notifications from your Lovable app through your Resend account.","keywords":["resend","email api","transactional email","marketing email","email notifications","send email from app","sending domain","resend api key"],"href":"/integrations/resend"},{"title":"Connect your app to Slack","sidebarTitle":"Slack","description":"Connect your app to Slack by signing in with your Slack account, to send messages, read channels, automate alerts, and generate digests, or add the app you built to Slack as its own agent.","keywords":["slack integration","slack connector","slack bot","slack automation","send slack notifications","read slack messages","slack workspace integration","add agent to slack","deploy app to slack","slack bot builder"],"href":"/integrations/slack"},{"title":"Connect your app to Telegram","sidebarTitle":"Telegram","description":"Send and receive Telegram messages in apps you build with Lovable. This is for app integrations, not for chatting with Lovable in Telegram.","keywords":["telegram integration","telegram connector","telegram bot","bot token","telegram notifications","telegram messages","botfather","lovable telegram integration"],"href":"/integrations/telegram"},{"title":"Connect your app to Twilio","sidebarTitle":"Twilio","description":"Connect your app to Twilio to send SMS and MMS messages, make voice calls, and add phone-based communication flows directly to your Lovable app.","keywords":["twilio","sms","mms","voice calls","phone verification","whatsapp","messaging","twilio api key"],"href":"/integrations/twilio"},{"title":"Connect your app to WhatsApp Business","sidebarTitle":"WhatsApp Business","description":"Connect your app to WhatsApp Business to receive customer messages, send replies and notifications, and manage message templates.","keywords":["whatsapp business","whatsapp connector","customer messaging","customer support","message templates","whatsapp notifications"],"href":"/integrations/whatsapp"}]},{"group":"CRM \u0026 sales","pages":[{"title":"Connect your app to Apollo.io","sidebarTitle":"Apollo.io","description":"Connect your app to Apollo.io to search its B2B database of people and companies, enrich contact and organization data, and manage contacts, accounts, and deals from your Lovable app.","keywords":["apollo.io","apollo","sales","prospecting","leads","b2b","enrichment","crm"],"href":"/integrations/apollo"},{"title":"Connect your app to Attention","sidebarTitle":"Attention","description":"Connect your app to Attention, a sales conversation intelligence platform, to read meeting transcripts and scorecards, write back snippets and QA results, and ask natural-language questions across your sales conversations.","keywords":["Attention","Attention connector","Attention API","sales conversation intelligence","meeting transcripts","scorecards","coaching","revenue intelligence","Lovable Attention"],"href":"/integrations/attention"},{"title":"Connect your app to Attio","sidebarTitle":"Attio","description":"Connect your app to Attio to read and update CRM records, manage list entries, and create notes and tasks for sales and customer workflows.","keywords":["attio","customer relationship management","contact management","lead capture","customer database","sales operations"],"href":"/integrations/attio"},{"title":"Connect your app to Clay","sidebarTitle":"Clay","description":"Connect your app to Clay, a go-to-market data platform, to search people and companies, run enrichment routines, and query Clay tables from your Lovable app.","keywords":["clay","gtm data","lead enrichment","prospecting","people search","company search","clay api","sales intelligence"],"href":"/integrations/clay"},{"title":"Connect your app to Gong","sidebarTitle":"Gong","description":"Connect your app to Gong to work with sales call metadata, transcripts, conversation topics, interaction stats, and user data from your Gong account.","keywords":["Gong","Gong connector","Gong API","revenue intelligence","sales calls","call transcripts","conversation analytics","deal activity","Lovable Gong"],"href":"/integrations/gong"},{"title":"Connect your app to HubSpot","sidebarTitle":"HubSpot","description":"Connect your app to HubSpot, a CRM platform, to manage contacts, track deals, and automate sales and marketing workflows.","keywords":["HubSpot integration","HubSpot connector","CRM integration","HubSpot automation","manage contacts","track deals","sales pipeline","marketing automation","Lovable HubSpot integration"],"href":"/integrations/hubspot"},{"title":"Connect your app to KLIPY","sidebarTitle":"KLIPY","description":"Connect your app to KLIPY to search and embed GIFs, stickers, and clips, and generate AI emojis.","keywords":["klipy","gif","sticker","clip","ai emojis","emojis","media","giphy alternative","tenor alternative","media picker"],"href":"/integrations/klipy"},{"title":"Connect your app to Pipedrive","sidebarTitle":"Pipedrive","description":"Connect your app to Pipedrive, a sales CRM, to manage deals, contacts, activities, leads, and sales pipeline data from your Lovable app.","keywords":["pipedrive","crm","sales","deals","contacts","pipelines","leads","oauth"],"href":"/integrations/pipedrive"},{"title":"Connect your app to Salesforce","sidebarTitle":"Salesforce","description":"Connect your app to Salesforce, a CRM platform, to read and manage Accounts, Contacts, Cases, and other records.","keywords":["salesforce","crm","accounts","contacts","cases","leads","soql"],"href":"/integrations/salesforce"},{"title":"Connect your app to Zendesk","sidebarTitle":"Zendesk","description":"Connect your app to Zendesk, the customer service platform, to list, search, create, and update support tickets, look up customers, and read help center articles from your Lovable app.","keywords":["zendesk","zendesk support","support tickets","help desk","customer service","help center","ticketing","zendesk api token"],"href":"/integrations/zendesk"},{"title":"Connect your app to Zoho CRM","sidebarTitle":"Zoho CRM","description":"Connect your app to Zoho CRM, a sales CRM platform, to read and manage leads, contacts, accounts, deals, and other CRM records.","keywords":["zoho crm","crm","sales","leads","contacts","deals","accounts","records"],"href":"/integrations/zoho-crm"}]},{"group":"Developer tools","pages":[{"title":"Connect your app to AWS API","sidebarTitle":"AWS API","description":"Connect your app to AWS API to call any Amazon Web Services API, such as EC2, DynamoDB, Lambda, SQS, and CloudWatch, from your Lovable app.","keywords":["aws api","aws","amazon web services","ec2","dynamodb","lambda","cloudwatch","sqs"],"href":"/integrations/aws"},{"title":"Connect your app to Azure Cloud API","sidebarTitle":"Azure Cloud API","description":"Connect your app to Azure Cloud API to inventory and manage Azure resources, inspect role assignments, and build cost and activity dashboards from your Lovable app.","keywords":["azure cloud api","azure","azure resource manager","arm","azure rbac","azure cost management","azure activity log","microsoft azure"],"href":"/integrations/azure"},{"title":"Connect your app to Azure Graph \u0026 Entra API","sidebarTitle":"Azure Graph \u0026 Entra API","description":"Connect your app to Azure Graph \u0026 Entra API to read and administer your organization's Microsoft Entra directory and Microsoft 365 data through Microsoft Graph, without a signed-in user.","keywords":["azure graph","entra api","microsoft graph","microsoft entra","entra id","microsoft 365 admin","sharepoint","intune"],"href":"/integrations/azure-graph"},{"title":"Connect your app to Cloudflare API","sidebarTitle":"Cloudflare API","description":"Connect your app to Cloudflare with an API token to inventory zones and DNS records, build traffic and security dashboards, manage DNS, purge cache, and operate Workers, R2, and KV.","keywords":["Cloudflare","Cloudflare API","DNS","CDN","WAF","Workers","R2","Zero Trust","zone analytics","Lovable Cloudflare"],"href":"/integrations/cloudflare-api"},{"title":"Connect your app to GitHub API","sidebarTitle":"GitHub API","description":"Connect your app to GitHub by signing in with your GitHub account or with a personal access token, to read repositories, manage issues and pull requests, and build automations with the GitHub REST API.","keywords":["github","github api","repositories","issues","pull requests","rest api","personal access token","github automation"],"href":"/integrations/github-api"},{"title":"Connect your app to GitLab API","sidebarTitle":"GitLab API","description":"Connect your app to GitLab.com, GitLab Self-Managed, or GitLab Dedicated to work with projects, issues, merge requests, pipelines, and repository files through the GitLab REST API.","keywords":["gitlab","gitlab api","gitlab connector","access token","personal access token","project access token","group access token","gitlab oauth","projects","issues","merge requests","pipelines","repository files","rest api","gitlab automation"],"href":"/integrations/gitlab-api"},{"title":"Connect your app to Google Cloud API","sidebarTitle":"Google Cloud API","description":"Connect your app to Google Cloud API to inventory resources, read monitoring and logging data, inspect IAM, and manage Google Cloud projects from your Lovable app.","keywords":["google cloud api","gcp","google cloud","google cloud platform","workload identity federation","cloud monitoring","cloud asset inventory","google cloud iam"],"href":"/integrations/gcp"},{"title":"Connect your app to Inngest","sidebarTitle":"Inngest","description":"Connect your app to Inngest to add background jobs, scheduled tasks, and durable workflows to your Lovable apps using your own Inngest account.","keywords":["Inngest integration","Inngest connector","Lovable Inngest","background jobs","scheduled tasks","cron jobs","durable workflows","event-driven","Inngest API key"],"href":"/integrations/inngest"},{"title":"Connect your app to Jira","sidebarTitle":"Jira","description":"Connect your app to Jira, Atlassian's issue and project tracker, by signing in with your Atlassian account to search, create, and update issues.","keywords":["jira","jira cloud","atlassian","issue tracking","bug tracking","sprints","jql","agile boards"],"href":"/integrations/jira"},{"title":"Connect your app to Linear","sidebarTitle":"Linear","description":"Connect your app to Linear to create and update issues, read project and team data, and build issue tracking workflows in your Lovable apps.","keywords":["Linear integration","Linear connector","Linear issues","Linear projects","Linear teams","issue tracking","project management","Linear OAuth","Lovable Linear integration"],"href":"/integrations/linear"},{"title":"Connect your app to Logo.dev","sidebarTitle":"Logo.dev","description":"Connect your app to Logo.dev to display company logos by domain, stock ticker, or crypto symbol directly in the browser from your Lovable app.","keywords":["logo.dev","company logos","brand images","favicon","stock ticker logos","crypto logos","directory","dashboard"],"href":"/integrations/logo-dev"},{"title":"Connect your app to the Lovable API","sidebarTitle":"Lovable API connector","description":"Connect your app to the Lovable API to list and manage projects, publish, embed project previews, and read analytics, members, and security insights for a connected Lovable workspace.","keywords":["lovable api","lovable connector","workspace management","projects api","publish api","embed url","workspace analytics","security scans","security insights","pii labels","api key"],"href":"/integrations/lovable-api-connector"},{"title":"Connect your app to n8n","sidebarTitle":"n8n","description":"Connect your app to n8n, a workflow automation tool, to list workflows, read executions, and trigger webhooks from your Lovable app.","keywords":["n8n","n8n cloud","self-hosted n8n","workflows","workflow executions","webhooks","publish workflow","workflow automation"],"href":"/integrations/n8n"},{"title":"Connect your app to Retool","sidebarTitle":"Retool","description":"Connect your app to Retool to manage organization users and groups, browse apps and workflows, and embed existing tools in your Lovable app.","keywords":["retool","internal tools","user provisioning","access reviews","embedded dashboards","low-code"],"href":"/integrations/retool"},{"title":"Connect your app to Sentry","sidebarTitle":"Sentry","description":"Connect your app to Sentry to report browser and server errors and performance data from your Lovable app with a Sentry client key (DSN).","keywords":["sentry","error tracking","crash reporting","bug tracking","exception monitoring","application monitoring","sentry dsn","client keys"],"href":"/integrations/sentry"}]},{"group":"E-commerce","pages":[{"title":"Connect your app to Lightspeed","sidebarTitle":"Lightspeed","description":"Connect your app to Lightspeed Retail X-Series, a retail POS platform, to work with products, inventory, outlets, customers, and sales data from your Lovable app.","keywords":["lightspeed","retail pos","inventory","products","sales","customers","ecommerce","oauth"],"href":"/integrations/lightspeed"},{"title":"Connect your app to PrestaShop","sidebarTitle":"PrestaShop","description":"Connect your app to PrestaShop, an open-source ecommerce platform, to read and manage store catalog, order, customer, and inventory data.","keywords":["prestashop","ecommerce","online store","webservice api","products","orders","inventory","catalog"],"href":"/integrations/prestashop"},{"title":"Build a Shopify store with AI","sidebarTitle":"Shopify","description":"Learn how to create a new Shopify store or connect an existing one to Lovable, build and launch your storefront, and add an admin dashboard for orders, customers, and inventory.","keywords":["Shopify","Shopify integration","Shopify store","e-commerce platform","ecommerce","AI store builder","online store setup","connect existing Shopify store","create Shopify store","shopify sandbox","manage store","claim store","launch store","Shopify admin dashboard","Shopify orders","Shopify Admin API","Shopify Dev Dashboard"],"href":"/integrations/shopify"},{"title":"Connect your app to WooCommerce","sidebarTitle":"WooCommerce","description":"Connect your app to WooCommerce, an ecommerce plugin for WordPress, to read and manage store products, orders, customers, coupons, and reports.","keywords":["woocommerce","ecommerce","wordpress","online store","products","orders","customers","coupons","woocommerce rest api"],"href":"/integrations/woocommerce"}]},{"group":"Finance \u0026 accounting","pages":[{"title":"Connect your app to Fortnox","sidebarTitle":"Fortnox","description":"Connect your app to Fortnox, a Swedish accounting and business administration platform, to work with customers, invoices, orders, suppliers, articles, and bookkeeping.","keywords":["fortnox","accounting","invoicing","bookkeeping","customers","suppliers","orders","supplier invoices"],"href":"/integrations/fortnox"},{"title":"Connect your app to Lexware","sidebarTitle":"Lexware","description":"Connect your app to Lexware, an accounting and invoicing platform, to work with contacts, invoices, vouchers, articles, and accounting events from your Lovable app.","keywords":["lexware","accounting","bookkeeping","invoices","vouchers","contacts","api key","webhooks"],"href":"/integrations/lexware"},{"title":"Connect your app to Sevdesk","sidebarTitle":"Sevdesk","description":"Connect your app to Sevdesk, an accounting and invoicing platform, to manage contacts, invoices, orders, vouchers, and bookkeeping workflows from your Lovable app.","keywords":["sevdesk","accounting","invoicing","bookkeeping","contacts","vouchers","orders","api token"],"href":"/integrations/sevdesk"},{"title":"Connect your app to Wave","sidebarTitle":"Wave","description":"Connect your app to Wave, an accounting and invoicing platform, to build apps that work with customers, products, invoices, estimates, and business accounting data.","keywords":["wave","wave connector","wave integration","accounting","invoices","customers","estimates","small business"],"href":"/integrations/wave"},{"title":"Connect your app to Xero","sidebarTitle":"Xero","description":"Connect your app to Xero, a cloud accounting platform, to work with contacts, invoices, bills, payments, bank transactions, and financial reports.","keywords":["xero","accounting","bookkeeping","invoices","bills","payments","bank transactions","financial reports"],"href":"/integrations/xero"},{"title":"Connect your app to Zoho Books","sidebarTitle":"Zoho Books","description":"Connect your app to Zoho Books, an accounting platform, to read and manage customers, invoices, estimates, bills, expenses, and projects.","keywords":["zoho books","accounting","invoices","expenses","customers","bookkeeping","sales orders","bills"],"href":"/integrations/zoho-books"}]},{"group":"Maps \u0026 location","pages":[{"title":"Connect your app to Google Maps Platform","sidebarTitle":"Google Maps Platform","description":"Connect Google Maps Platform to your Lovable app to geocode addresses, calculate routes, search places, show maps, and get weather and air quality data.","keywords":["google maps platform","google maps connector","maps javascript api","places api","routes api","geocoding api","geocode addresses","embed map","weather api","air quality"],"href":"/integrations/google-maps"},{"title":"Connect your app to Mapbox","sidebarTitle":"Mapbox","description":"Connect your app to Mapbox, a location platform, to embed interactive maps with Mapbox GL JS, geocode addresses, and calculate routes and directions from your Lovable app.","keywords":["mapbox","maps","geocoding","directions","mapbox gl js","routing","navigation","location","isochrones"],"href":"/integrations/mapbox"}]},{"group":"Marketing \u0026 social","pages":[{"title":"Connect your app to ActiveCampaign","sidebarTitle":"ActiveCampaign","description":"Connect your app to ActiveCampaign to manage contacts and mailing lists, create and schedule email campaigns, and work with audience segments.","keywords":["activecampaign","email marketing","newsletter signup","contact management","mailing lists","campaign scheduling","audience segmentation"],"href":"/integrations/activecampaign"},{"title":"Connect your app to beehiiv","sidebarTitle":"beehiiv","description":"Connect your app to beehiiv, a newsletter platform, to add subscribers and show posts from your Lovable app.","keywords":["beehiiv","newsletter","subscribers","signup form","posts","publication","email newsletter"],"href":"/integrations/beehiiv"},{"title":"Connect your app to Bing Webmaster Tools","sidebarTitle":"Bing Webmaster Tools","description":"Connect your app to Bing Webmaster Tools, Microsoft's service for Bing search performance, to read clicks, queries, and crawl stats and to submit URLs and sitemaps.","keywords":["bing webmaster tools","bing search console","seo","search clicks","crawl stats","sitemaps","url submission"],"href":"/integrations/bing-webmaster-tools"},{"title":"Connect your app to Google Analytics","sidebarTitle":"Google Analytics","description":"Connect your app to Google Analytics 4 to track page views, custom events, and conversions from your Lovable app using gtag.js.","keywords":["google analytics","ga4","gtag","measurement id","page views","event tracking","conversions","web analytics"],"href":"/integrations/google-analytics"},{"title":"Connect Google Business Profile to Lovable","sidebarTitle":"Google Business Profile","description":"Connect Google Business Profile to manage your business locations, opening hours, reviews, posts, and performance directly in Lovable or in your published app.","keywords":["google business profile","google my business","gmb","google maps","google search","business listings","google reviews","opening hours","local seo"],"href":"/integrations/google-business-profile"},{"title":"Connect your app to Google Search Console (GSC)","sidebarTitle":"Google Search Console","description":"Connect your app to Google Search Console (GSC), Google's free service for monitoring search performance, to verify domains, submit sitemaps, read search analytics, and answer SEO questions directly in the project chat, or to build SEO features into your Lovable app.","keywords":["Google Search Console integration","GSC connector","Search Console API","SEO analytics","search performance","sitemaps","URL inspection","site verification","Lovable Google Search Console","Google OAuth"],"href":"/integrations/google-search-console"},{"title":"Connect your app to Klaviyo","sidebarTitle":"Klaviyo","description":"Connect your app to Klaviyo, an email and SMS platform, to sync profiles, lists, and events, and to read campaigns and flows.","keywords":["klaviyo","email marketing","sms","profiles","campaigns","flows","lists","subscribers"],"href":"/integrations/klaviyo"},{"title":"Connect your app to LinkedIn","sidebarTitle":"LinkedIn","description":"Connect your app to LinkedIn, a professional networking platform, to read member profile data and publish posts from your Lovable app.","keywords":["LinkedIn integration","LinkedIn connector","Lovable LinkedIn","LinkedIn API","professional network","OAuth","publish posts","member profile"],"href":"/integrations/linkedin"},{"title":"Connect your app to Loops","sidebarTitle":"Loops","description":"Connect your app to Loops, an email platform for contacts and transactional email, to create contacts, send events, and send transactional email from your Lovable app.","keywords":["loops","loops.so","transactional email","contacts","mailing lists","newsletter","email automations"],"href":"/integrations/loops"},{"title":"Connect your app to Mailchimp","sidebarTitle":"Mailchimp","description":"Connect your app to Mailchimp to collect newsletter signups, manage audience contacts and tags, and display campaign performance in your Lovable app.","keywords":["mailchimp","mailchimp marketing","email marketing","mailing list","subscriber sync","double opt-in"],"href":"/integrations/mailchimp"},{"title":"Connect your app to PostHog","sidebarTitle":"PostHog","description":"Connect your app to PostHog to capture product analytics events, evaluate feature flags, and send server-side events from your Lovable app.","keywords":["posthog","product analytics","feature flags","event capture","posthog-js","analytics","A/B testing","Lovable PostHog integration"],"href":"/integrations/posthog"},{"title":"Connect your app to Semrush","sidebarTitle":"Semrush","description":"Connect your app to Semrush, an SEO and competitive analysis platform, to power apps with keyword research, domain analytics, backlink data, and project management.","keywords":["Semrush integration","Semrush connector","Semrush API","SEO","keyword research","domain analytics","backlinks","position tracking","competitive analysis","Lovable Semrush","Semrush OAuth"],"href":"/integrations/semrush"},{"title":"Connect your app to TikTok","sidebarTitle":"TikTok","description":"Connect your app to TikTok to read creator profiles, fetch published videos, and build social integrations from your Lovable app. ","keywords":["TikTok integration","TikTok connector","Lovable TikTok","TikTok API","creator tools","video metadata","social media integration"],"href":"/integrations/tiktok"},{"title":"Connect your app to Twitch","sidebarTitle":"Twitch","description":"Connect your app to Twitch to build custom stream overlays, display live stream data, track channel activity, and create tools for creators and communities directly from your Lovable app.","keywords":["twitch","streaming","live stream","gaming","chat","channels","clips","creators"],"href":"/integrations/twitch"},{"title":"Connect your app to X (Twitter)","sidebarTitle":"X (Twitter)","description":"Connect your app to X with an app-only Bearer token to look up users, search recent public posts, and build social integrations from your Lovable app.","keywords":["x","twitter","x api","social media","posts","tweets","bearer token","user lookup","post search"],"href":"/integrations/x"}]},{"group":"Payments \u0026 billing","pages":[{"title":"Connect your app to Adyen","sidebarTitle":"Adyen","description":"Connect your app to Adyen, a payments company, to take cards, wallets, and local payment methods such as iDEAL from your Lovable app.","keywords":["adyen checkout","online payments","apple pay","google pay","card payments","3d secure"],"href":"/integrations/adyen"},{"title":"Connect your app to Airwallex","sidebarTitle":"Airwallex","description":"Connect your app to Airwallex to accept payments, share payment links, manage subscriptions and invoices, and display balances by currency.","keywords":["airwallex","hosted checkout","payment links","recurring billing","multi-currency balances","sandbox payments"],"href":"/integrations/airwallex"},{"title":"Connect your app to Asaas","sidebarTitle":"Asaas","description":"Connect your app to Asaas to accept Pix, boleto, and credit card payments in Brazil, track which orders are paid, and manage recurring charges.","keywords":["asaas","pix","boleto","brazilian payments","assinatura","cobrança","recurring billing"],"href":"/integrations/asaas"},{"title":"Connect your app to Chargebee","sidebarTitle":"Chargebee","description":"Connect your app to Chargebee, a subscription billing and revenue management platform, to manage customers, subscriptions, invoices, checkout, and billing workflows.","keywords":["chargebee","subscription billing","revenue management","customers","subscriptions","invoices","hosted checkout","billing portal"],"href":"/integrations/chargebee"},{"title":"Connect your app to GoCardless","sidebarTitle":"GoCardless","description":"Connect your app to GoCardless, a bank payments provider, to collect one-off payments and recurring direct debits from your Lovable app.","keywords":["gocardless","direct debit","bank payments","instant bank pay","recurring payments","mandates","subscriptions"],"href":"/integrations/gocardless"},{"title":"Connect your app to Mercado Pago","sidebarTitle":"Mercado Pago","description":"Connect your app to Mercado Pago, a Latin American payments provider, to take payments with Pix, cards, and Checkout Pro from your Lovable app.","keywords":["mercado pago","mercadopago","pix","checkout pro","latin america payments","brazil payments","subscriptions","assinatura"],"href":"/integrations/mercadopago"},{"title":"Connect your app to Mollie","sidebarTitle":"Mollie","description":"Connect your app to Mollie, a European payments provider, to take payments with iDEAL, Bancontact, cards, and other methods from your Lovable app.","keywords":["mollie","ideal","bancontact","online payments","checkout","sepa","european payments"],"href":"/integrations/mollie"},{"title":"Connect your app to PayPal","sidebarTitle":"PayPal","description":"Connect your app to PayPal to create checkouts, capture approved orders, issue refunds, and read order details in sandbox and live.","keywords":["paypal","paypal rest api","client id and secret","sandbox account","transaction search","paypal credentials not valid"],"href":"/integrations/paypal"},{"title":"Connect your app to Paystack","sidebarTitle":"Paystack","description":"Connect your app to Paystack, a payments provider for businesses in Africa, to take card, bank transfer, and mobile money payments from your Lovable app.","keywords":["paystack","nigeria payments","naira","mobile money","m-pesa","ussd","ghana","kenya","south africa","online checkout"],"href":"/integrations/paystack"},{"title":"Connect your app to Pledge","sidebarTitle":"Pledge","description":"Connect your app to Pledge, a charitable giving platform, to search verified nonprofits worldwide, create donations, and manage fundraisers from your Lovable app.","keywords":["Pledge","Pledge connector","Pledge API","donations","charitable giving","nonprofit search","fundraisers","philanthropy","donation API","Lovable Pledge"],"href":"/integrations/pledge"},{"title":"Connect your app to Ramp","sidebarTitle":"Ramp","description":"Connect your app to Ramp, a corporate card and spend management platform, to build apps that read transactions, cards, funds, users, and business data.","keywords":["ramp","ramp corporate cards","spend management","expense management","ramp transactions","spend dashboard","card limits"],"href":"/integrations/ramp"},{"title":"Connect your app to Razorpay","sidebarTitle":"Razorpay","description":"Connect your app to Razorpay, an Indian payments provider, to take UPI, card, netbanking, and wallet payments in your Lovable app.","keywords":["razorpay","upi","india payments","inr","netbanking","razorpay checkout","payment links","upi autopay"],"href":"/integrations/razorpay"},{"title":"Connect your app to Square","sidebarTitle":"Square","description":"Connect your app to Square, a payments and point-of-sale provider, to take payments, create payment links, and work with orders and customers from your Lovable app.","keywords":["square","squareup","square payments","point of sale","payment links","online checkout","refunds"],"href":"/integrations/square"},{"title":"Connect your own Stripe account","sidebarTitle":"Stripe","description":"Accept one-time payments and subscriptions with a Stripe account you own. Lovable builds the checkout through chat using your Stripe API key.","keywords":["Stripe integration","own Stripe account","bring your own key","BYOK","Stripe secret key","Stripe restricted key","STRIPE_SECRET_KEY","add API key","customer portal"],"boost":0.5,"href":"/integrations/stripe"}]},{"group":"Productivity","pages":[{"title":"Connect your app to Airtable","sidebarTitle":"Airtable","description":"Connect your app to Airtable, a spreadsheet-database hybrid, to read and write bases, tables, and records, and turn an Airtable base into a custom app interface.","keywords":["Airtable integration","Airtable connector","Airtable personal access token","Airtable PAT","Lovable Airtable","Airtable bases","Airtable records","Airtable API"],"href":"/integrations/airtable"},{"title":"Connect your app to Asana","sidebarTitle":"Asana","description":"Connect your app to Asana with a personal access token (PAT) to create and update tasks, read project and team data, and automate work tracking workflows in your Lovable apps.","keywords":["Asana integration","Asana connector","Asana personal access token","Asana PAT","Lovable Asana","task management automation","Asana API"],"href":"/integrations/asana"},{"title":"Connect your app to Ashby","sidebarTitle":"Ashby","description":"Connect your app to Ashby, a recruiting and applicant tracking system, to work with jobs, candidates, applications, and hiring workflows.","keywords":["ashby","ats","recruiting","hiring","candidates","jobs","applications","applicant tracking"],"href":"/integrations/ashby"},{"title":"Connect your app to BambooHR","sidebarTitle":"BambooHR","description":"Connect your app to BambooHR, HR software for employee records and time off, to build directories, time off views, and HR reports in your Lovable app.","keywords":["bamboohr","bamboo hr","hris"],"href":"/integrations/bamboohr"},{"title":"Connect your app to Calendly","sidebarTitle":"Calendly","description":"Connect your app to Calendly, a scheduling automation platform, to build booking flows, event dashboards, and meeting workflows.","keywords":["calendly","scheduling","appointments","meetings","calendar","event types","invitees"],"href":"/integrations/calendly"},{"title":"Connect your app to ClickUp","sidebarTitle":"ClickUp","description":"Connect your app to ClickUp, a work management platform for tasks, docs, and time tracking, to read and manage that work from your Lovable app.","keywords":["clickup","task management","time tracking","clickup docs","personal token","project board"],"href":"/integrations/clickup"},{"title":"Connect your app to Deel","sidebarTitle":"Deel","description":"Connect your app to Deel, the global payroll and HR platform, to build with your contracts, people, timesheets, time off, and payments.","keywords":["deel","payroll","contractors","employer of record","hris","timesheets","time off"],"href":"/integrations/deel"},{"title":"Connect your app to Fireflies","sidebarTitle":"Fireflies","description":"Connect your app to Fireflies to access meeting transcripts, summaries, and conversation insights.","keywords":["Fireflies","Fireflies.ai","meeting transcription","transcripts","GraphQL","Lovable Fireflies"],"href":"/integrations/fireflies"},{"title":"Connect your app to Google Workspace","sidebarTitle":"Google Workspace","description":"Connect your app to Google Workspace to read and send email, manage calendars, store and create files, and use Google tools like Sheets, Docs, and Slides as part of your app's workflows.","keywords":["Google Workspace integration","Google connector","Gmail integration","Google Sheets integration","Google Calendar integration","Google Drive integration","Google Docs integration","Google Slides integration","Lovable Google integration","Google OAuth"],"href":"/integrations/google-workspace"},{"title":"Connect your app to Granola","sidebarTitle":"Granola","description":"Connect your app to Granola, an AI meeting notes platform, to bring meeting notes, AI summaries, and transcripts from your Granola workspace into your Lovable apps.","keywords":["Granola","Granola connector","Granola API","meeting notes","meeting transcripts","AI meeting summaries","Lovable Granola"],"href":"/integrations/granola"},{"title":"Connect your app to incident.io","sidebarTitle":"incident.io","description":"Connect your app to incident.io to work with incidents, follow-ups, alerts, on-call schedules, status pages, and catalog data.","keywords":["incident.io","incident management","on-call","alerts","status pages","follow-ups","service catalog","incident response"],"href":"/integrations/incidentio"},{"title":"Connect your app to Microsoft 365","sidebarTitle":"Microsoft","description":"Connect Microsoft Outlook, Teams, OneDrive, SharePoint, Word, Excel, PowerPoint, and OneNote to your Lovable app. All use the same Microsoft sign-in and Microsoft Graph pattern, so one guide covers every Microsoft connector.","keywords":["Microsoft","Microsoft 365","Microsoft Graph","Outlook","Teams","OneDrive","SharePoint","Excel","Word","PowerPoint","OneNote","Office 365","OAuth","Lovable Microsoft"],"href":"/integrations/microsoft"},{"title":"Build and publish apps to Microsoft Copilot Managed Runtime","sidebarTitle":"Copilot Managed Runtime","description":"Build an app in Lovable and publish it to Microsoft Copilot Managed Runtime, where it runs inside your company's Microsoft Entra tenant under your organization's sign-in and IT policies.","keywords":["Microsoft Copilot Managed Runtime","Copilot Managed Runtime","Copilot Managed Runtime SDK","managed apps","code apps","deploy to Microsoft","internal tools Microsoft 365","Entra","Dataverse","Power Platform","Power Apps"],"href":"/integrations/microsoft-copilot-managed-runtime"},{"title":"Set up your Microsoft tenant for Copilot Managed Runtime","sidebarTitle":"Copilot Managed Runtime tenant setup","description":"The one-time setup a Microsoft tenant admin completes so builders can publish Lovable apps into your organization using Copilot Managed Runtime.","keywords":["Copilot Managed Runtime","Microsoft Copilot Managed Runtime tenant setup","managed apps setup","Microsoft tenant setup","admin consent","Entra App Gallery","Consent on behalf of your organization","Entra enterprise application","Lovable managed apps","external artifact deployment","Power Platform admin center","Conditional Access"],"href":"/integrations/microsoft-copilot-managed-runtime-tenant-setup"},{"title":"Connect your app to Notion","sidebarTitle":"Notion","description":"Connect your app to Notion, an all-in-one workspace for docs, wikis, and databases, to read and write pages, query databases, and build apps backed by content your team manages in Notion.","keywords":["Notion integration","Notion connector","Notion app + chat connector","Notion API","Notion pages","Notion databases","Notion OAuth","content management","Lovable Notion integration"],"href":"/integrations/notion"},{"title":"Connect your app to Scrive for e-signatures and eID","sidebarTitle":"Scrive","description":"Connect your app to Scrive to send documents for e-signature with Scrive eSign, or verify user identities with BankID, MitID, and other eIDs through eID Hub.","keywords":["Scrive","Scrive connector","Scrive eSign","Scrive eID Hub","e-signature","electronic signature","BankID","MitID","Freja","Smart-ID","itsme","identity verification","digital signing"],"href":"/integrations/scrive"},{"title":"Connect your app to Tally","sidebarTitle":"Tally","description":"Connect your app to Tally, the free-form builder, to create forms, fetch submissions, and manage form workflows from your Lovable app.","keywords":["tally","forms","form builder","surveys","submissions","webhooks","tally api"],"href":"/integrations/tally"},{"title":"Connect your app to Workday","sidebarTitle":"Workday","description":"Connect your app to Workday, the HR and workforce platform, to let each app user read worker, organization, and time off data with their own Workday permissions.","keywords":["workday","hr","hcm","hris","employees","time off","org chart","app user connector"],"href":"/integrations/workday"}]},{"group":"Security \u0026 compliance","pages":[{"title":"Run AI-powered penetration tests with Aikido","sidebarTitle":"Aikido","description":"Run AI-powered penetration tests on your Lovable projects with Aikido to identify real exploitable vulnerabilities and generate shareable security reports.","keywords":["aikido","pentest","penetration testing","AI pentesting","security","dynamic analysis","vulnerability scanning","SOC 2","ISO 27001","whitebox testing","blackbox testing"],"href":"/integrations/aikido"},{"title":"Scan your projects for vulnerabilities with Wiz","sidebarTitle":"Wiz","description":"Automatically scan your Lovable projects for vulnerabilities and code-security issues using Wiz to catch known CVEs and risky code patterns before you ship.","keywords":["wiz","vulnerability scanning","dependency scanning","SCA","software composition analysis","SAST","static application security testing","CVE","security","SBOM","dependency audit","enterprise security"],"href":"/integrations/wiz"}]},{"group":"Websites \u0026 CMS","pages":[{"title":"Connect your app to Contentful","sidebarTitle":"Contentful","description":"Connect your app to Contentful to fetch and display published content from your headless CMS, including entries, assets, and rich text.","keywords":["contentful","cms","headless cms","content delivery api","content management","blog","marketing pages"],"href":"/integrations/contentful"},{"title":"Connect your app to Storyblok","sidebarTitle":"Storyblok","description":"Connect your app to Storyblok, a headless CMS and visual page builder, to deliver published content or create and publish stories from your Lovable app.","keywords":["storyblok","cms","headless cms","visual page builder","content delivery","content management","stories","marketing pages"],"href":"/integrations/storyblok"},{"title":"Connect your app to Wix","sidebarTitle":"Wix","description":"Connect your app to Wix, a website and business platform, to read and manage Wix sites, ecommerce, bookings, CRM, and CMS resources.","keywords":["wix","wix api","wix api key","website","ecommerce","bookings","crm","cms"],"href":"/integrations/wix"},{"title":"Connect your app to WordPress (self-hosted)","sidebarTitle":"WordPress (self-hosted)","description":"Connect your app to a self-hosted WordPress site to read and manage posts, pages, media, and users through the WordPress REST API.","keywords":["wordpress","self-hosted wordpress","headless wordpress","wordpress rest api","application password","cms","blog","wordpress connector"],"href":"/integrations/wordpress"},{"title":"Connect your app to WordPress.com","sidebarTitle":"WordPress.com","description":"Connect your app to WordPress.com by signing in with your WordPress.com account, to read and manage posts, pages, and media on your WordPress.com sites.","keywords":["wordpress.com","headless wordpress","wordpress connector","wordpress rest api","cms","blog","posts","wordpress.com sites"],"href":"/integrations/wordpress-com"}]}]},{"title":"Integrate any API with Lovable","sidebarTitle":"Connect any API","description":"Connect any external service to your Lovable app, even one without a built-in connector. Create a custom connector so Lovable manages the credentials, or ask Lovable to connect the service directly.","keywords":["integrate API","any API","external API","REST API","API key","custom connector","connector gateway","Edge Functions","server functions","secrets","custom integration","third-party API","embed widget","instagram feed","social media feed"],"href":"/integrations/any-api"},{"group":"Git sync","root":{"title":"Sync your Lovable project code with GitHub, GitLab, or Bitbucket","sidebarTitle":"Git sync overview","description":"Git sync keeps your Lovable project code in your own GitHub, GitLab, or Bitbucket repository with automatic two-way sync, so you can back up code, collaborate with developers, work in your IDE, and deploy anywhere.","keywords":["git sync","github","gitlab","bitbucket","version control","export code","two-way sync","repository","sync project code","code backup","commit attribution","commit author","member email in commits","work locally","local development","IDE","clone repository","feature branch","transfer project to another workspace"],"href":"/integrations/git-sync-overview"},"pages":[{"title":"Sync your Lovable project with GitHub","sidebarTitle":"GitHub","description":"Export and two-way sync your Lovable project code with github.com, GitHub Enterprise Cloud, or GitHub Enterprise Server for code backup, collaboration, and deployment.","keywords":["github git sync","github sync","sync project to github","export to github","two-way sync","code backup","github repository","github branches","pull requests","local development","github enterprise cloud","github enterprise server","github enterprise","lovable github app"],"href":"/integrations/github"},{"title":"Sync your Lovable project with GitLab","sidebarTitle":"GitLab","description":"Export and two-way sync your Lovable project code with GitLab.com or a self-managed GitLab instance for code backup, collaboration, and deployment.","keywords":["Connect Lovable to GitLab","Export Lovable project to GitLab","GitLab integration","GitLab sync","gitlab git sync","Disconnect GitLab","Backup Lovable code","Sync Lovable and GitLab","GitLab repository setup","two-way sync","gitlab branches","merge requests","Lovable code export","GitLab integration guide","GitLab Self-Managed","self-hosted GitLab","enterprise GitLab"],"href":"/integrations/gitlab"},{"title":"Sync your Lovable project with Bitbucket","sidebarTitle":"Bitbucket","description":"Export and two-way sync your Lovable project code with a Bitbucket Cloud workspace for code backup, collaboration, and deployment.","keywords":["Connect Lovable to Bitbucket","Export Lovable project to Bitbucket","Bitbucket integration","Bitbucket sync","bitbucket git sync","Bitbucket Cloud","Atlassian","Disconnect Bitbucket","Backup Lovable code","Sync Lovable and Bitbucket","Bitbucket repository setup","two-way sync","bitbucket branches","pull requests","Lovable code export","Bitbucket integration guide","Bitbucket Data Center"],"href":"/integrations/bitbucket"}]}]},{"group":"Collaborate","icon":"users","pages":[{"title":"Collaboration","description":"Invite teammates to projects or workspaces, assign roles and permissions, and see changes in real time as you build together.","href":"/features/collaboration"},{"title":"Share a project with internal or external collaborators","sidebarTitle":"Share a project","description":"Manage project access, invite collaborators, and create protected preview links for external reviews.","keywords":["share project","project access","project collaborators","restricted projects","project access control","external collaborators","invite link","share preview","preview link password","preview link expiration","guest comments"],"href":"/features/share-project"},{"title":"Project comments","sidebarTitle":"Project comments","description":"Leave comments directly on elements in your project.","keywords":["comments","annotations","feedback","collaboration","project comments"],"href":"/features/project-comments"},{"title":"Control project access","sidebarTitle":"Project access","description":"Control who can view, remix, or collaborate on your projects. Choose whether projects are accessible to all workspace members, or restricted to invited users only.","keywords":["project visibility","workspace privacy settings","private projects","restricted projects","project access control","default project visibility","project privacy","business plan features","internal projects","workspace security"],"href":"/features/project-visibility"}]},{"group":"Deploy \u0026 host","icon":"globe","pages":[{"title":"How Lovable hosts your app","sidebarTitle":"Hosting","description":"Lovable hosts your published app for you: no servers to set up, HTTPS included, and delivery from locations around the world. Learn how hosting works.","keywords":["lovable hosting","host my app","where is my app hosted","lovable server","app hosting","publish website","does lovable host my app","https ssl","site down","lovable status"],"href":"/features/hosting"},{"title":"Publish your Lovable project","sidebarTitle":"Publish","description":"Publish your project to a live URL from the editor or the project chat, push later changes to the live site, and take the app offline when you need to.","keywords":["publish Lovable app","publish website","deploy project","publish to custom domain","go live","update published app","unpublish app","take a published site down","remove a live app","who can unpublish","approval to publish","publishing failed"],"href":"/features/publish"},{"title":"Control who can visit your published app","sidebarTitle":"Website access","description":"Choose who can visit your published app, invite people outside your workspace, and approve access requests. Website access is separate from project access.","keywords":["website access settings","private website access","public website access","publish to workspace","invite external viewers","share private app with clients","invite people outside workspace","invite-only publishing","invite limit","approve app access request","someone requested access to my app","password protect published app"],"href":"/features/website-access"},{"group":"Custom domains","root":{"title":"Set up a custom domain","sidebarTitle":"Custom domains","description":"Choose how to set up a custom domain, find where its DNS records live, and manage domain statuses, primary domains, and project connections.","keywords":["custom domains","connect custom domain","how to add custom domain","buy domain","primary domain","subdomain","domain status","SSL certificate","DNS verification","DNS setup","nameservers","A record","TXT record","MX record","add DNS record","where to add DNS records","who manages my DNS"],"href":"/features/custom-domain"},"pages":[{"title":"Buy a domain through Lovable","sidebarTitle":"Buy a domain","description":"Buy a domain in Lovable, connect it to a project now or later, and manage its registration, renewal, and contact details.","keywords":["buy domain","buy a domain through Lovable","register domain","domain price","domain renewal","auto-renew","WHOIS privacy","registration details","ICANN verification","transfer out","move domain to another workspace","domain extensions","TLD","premium domain"],"href":"/features/custom-domain-buy"},{"title":"Connect a domain from another provider","sidebarTitle":"Connect a domain","description":"Connect a domain you already own to a Lovable project, add its DNS records at your provider, verify the connection, and fix setup problems.","keywords":["connect custom domain","connect existing domain","connect a domain I already own","DNS records","A record","AAAA record","TXT record","verification record","Entri","manual DNS setup","CAA records","reverse proxy","Cloudflare proxy"],"href":"/features/custom-domain-connect"},{"title":"Transfer a domain to Lovable","sidebarTitle":"Transfer a domain","description":"Move a domain from another registrar to Lovable, so Lovable becomes your domain registrar.","keywords":["transfer domain","transfer in","domain transfer","move domain to Lovable","authorization code","EPP code","transfer code","registrar transfer","unlock domain","DNSSEC","ICANN 60 day lock","DNS records carry over","keep DNS records"],"href":"/features/transfer-domain"}]},{"title":"Publish every app in your workspace under your own domain","sidebarTitle":"Publishing domain","description":"Publish your Enterprise workspace's apps under one domain or subdomain with a one-time setup.","keywords":["workspace domain for all apps","delegate a subdomain to Lovable","nameserver delegation","NS records","apps subdomain","company domain for internal tools","publish under own domain","one domain for every project","delegated domain"],"tag":"ENT","href":"/features/publishing-domain"},{"title":"Publish apps with branded URLs","sidebarTitle":"Branded app URLs","description":"Create consistent, branded URLs for every app in your workspace.","keywords":["branded workspace URL","workspace URL","workspace branded subdomain","publish URL","enterprise URLs","use workspace URL"],"href":"/features/branded-workspace-urls"},{"group":"Ownership \u0026 portability","root":{"title":"Deployment, hosting, and ownership options with Lovable","sidebarTitle":"Ownership \u0026 portability","description":"What you own when you build with Lovable, which parts of an app can move to your own hosting or infrastructure, and which setup fits your requirements. For deployment and migration steps, see Deploying and hosting outside Lovable.","keywords":["lovable self-hosting","lovable production hosting","lovable deployment","lovable cloud hosting","lovable code ownership","lovable data portability","self-managed infrastructure","deploy lovable app"],"href":"/tips-tricks/deployment-hosting-ownership"},"pages":[{"title":"Deploying and hosting outside Lovable","sidebarTitle":"Host outside Lovable","description":"How to take your code out of Lovable, deploy your app to your own hosting, verify it, migrate the built-in backend to your own Supabase project, and complete a move away from Lovable, with examples for managed platforms and your own infrastructure.","href":"/tips-tricks/external-deployment-hosting"}]}]},{"group":"Grow \u0026 optimize","icon":"chart-line","pages":[{"title":"Growth tools","sidebarTitle":"Growth tools","description":"Get help finding customers, improving search visibility, creating marketing content, and running ads on Google, YouTube, Facebook, and Instagram.","keywords":["get more users","get more visitors","marketing","grow my app","seo","google ads","meta ads","facebook ads","instagram ads","google business profile","first customers"],"href":"/features/growth-tools"},{"title":"Optimize your app for SEO and AI search","sidebarTitle":"SEO and AEO","description":"Run an SEO and AI search review from the Analytics view, connect Google Search Console, and research keywords and content with Lovable to help your app rank on Google, Bing, and AI search engines.","keywords":["seo","seo review","ai search review","aeo","answer engine optimization","geo","generative engine optimization","seo tab","audience","search engine optimization","semrush","keyword research","competitor analysis","sitemap","robots.txt","structured data","open graph","google search console","gsc","indexing","custom domain seo","server-side rendering","ssr","prerendering","crawlability"],"href":"/features/seo-aeo"},{"title":"Change your site title, favicon, and social preview","sidebarTitle":"Site metadata","description":"Change your app's title, meta description, favicon, and social sharing image in the project chat, and check how each page looks when shared and in search.","keywords":["favicon","site icon","browser tab icon","OG image","meta description","social sharing image","link preview","share image","search appearance","site metadata","page title"],"href":"/features/site-metadata"},{"title":"Analytics","sidebarTitle":"Analytics","description":"Understand your app's traffic, search visibility, and ad campaign performance, and ask Lovable what to improve next.","keywords":["audience","analytics","project analytics","visits","visitors","traffic","channels","seo and ai","google search console","social traffic","referral traffic","ads traffic","get more visitors","cookieless analytics","cookie banner"],"href":"/features/analytics"},{"title":"Advertise your app","sidebarTitle":"Ads","description":"Create or import campaigns on Google, YouTube, Facebook, and Instagram. Lovable helps prepare your ads, manage campaigns, and improve performance over time.","keywords":["paid ads","ad campaign","google ads","meta ads","facebook ads","instagram ads","ad account","conversion tracking","performance max","demand gen","sign-up offer"],"href":"/features/ads"},{"title":"Add payments to your app","sidebarTitle":"Payments","description":"Accept subscriptions and one-time payments in any Lovable app using built-in Paddle or Stripe integration.","keywords":["payments","subscriptions","checkout","Paddle","Stripe","merchant of record","monetize","billing","pricing","one-time payments","SaaS","webhook secret","Invalid webhook signature"],"boost":2,"href":"/features/payments"},{"title":"Send branded emails from your own domain","sidebarTitle":"Emails","description":"Send branded emails, including authentication emails and custom app emails, from your own email domain with automatic DNS, SPF, DKIM, and DMARC setup to improve deliverability, protect your domain reputation, and strengthen brand trust.","keywords":["custom emails","email domain","authentication emails","transactional emails","app emails","email verification","SPF","DKIM","DMARC","email deliverability"],"href":"/features/custom-emails"},{"title":"Publish your app as an MCP server","sidebarTitle":"Agent integrations","description":"Turn a published Lovable app into an MCP server for ChatGPT, Claude, and other AI assistants. Configure tools, sign-in, permissions, and access.","keywords":["agent integrations","publish app as MCP server","app MCP server","make my app work in ChatGPT","make my app work in Claude","connect my app to AI assistants","let AI use my app","app tools for AI assistants","MCP link","workspace app MCP","internal app AI assistant","use my app from Lovable chat","Lovable apps connector","add app to Lovable","WebMCP","browser agent","site tools","browser tools"],"href":"/features/agent-integrations"},{"title":"Project monitoring","description":"Let Lovable check your app on a schedule, catch bugs and visitor errors early, alert you by email, and help you fix them in the project chat.","keywords":["project monitoring","lovable project monitoring","app monitoring","error monitoring","bug detection","automated QA","health checks","scheduled checks","error logs","app health","integration errors","failed API calls"],"href":"/features/project-monitoring"}]},{"group":"Workspace \u0026 account","icon":"gear","pages":[{"group":"Workspace","root":{"title":"Lovable workspace","sidebarTitle":"Workspace","description":"Manage your team's projects, members, billing, and settings in one central place.","keywords":["invitation expired","invited with a different email","can't find invitation","lost invitation email"],"href":"/features/workspace"},"pages":[{"title":"Workspace admin settings","sidebarTitle":"Admin settings","description":"Overview of settings available to workspace owners and admins, including workspace details, access and organization, templates, billing and usage, workspace domains, security and compliance, and development settings.","keywords":["workspace settings","workspace administration","workspace admin","workspace identity","workspace handle","usage limits","usage alerts","credit limits","branded app URLs","people","groups","templates","design systems","plans and credit usage","workspace domains","privacy and security","identity","SSO","SCIM","security center","insights","workspace insights","adoption metrics","audit logs","data exports","build secrets","git connections","github","gitlab","bitbucket","MCP server"],"href":"/features/workspace-admin-settings"},{"title":"Show an announcement banner to your workspace","sidebarTitle":"Announcements","description":"Post one message, with links and a countdown timer, that every workspace member sees in Lovable.","keywords":["announcements","announcement banner","workspace banner","workspace announcements","banner","countdown banner","hackathon banner","workspace-wide message","dismiss banner"],"href":"/features/workspace-announcements"},{"title":"Insights","description":"See how your workspace adopts Lovable, with visits, active apps, active builders, connections added, top apps ranked by visits, and builders ranked by edits.","sidebarTitle":"Insights","keywords":["insights","workspace insights","adoption metrics","workspace adoption","active apps","app visits","active builders","connections added","connector usage","top apps","top builders","builder activity","edits","visits","workspace reporting","app inventory"],"href":"/features/insights"},{"title":"Delete a workspace","description":"Delete a workspace you no longer need, learn what happens to its projects, members, and billing, and restore it within 60 days if you change your mind.","keywords":["remove workspace","permanently delete workspace","60 day grace period","recover workspace","undelete workspace","workspace owner","cancel workspace","workspace billing cancel","workspace projects deleted","members lose access","workspace switcher"],"href":"/introduction/delete-workspace"}]},{"group":"Organizations","root":{"title":"Organizations: manage several Enterprise workspaces together","sidebarTitle":"Organizations","description":"Group your company's Lovable workspaces under one organization: set up SSO and SCIM once, see every member and role in one place, and publish apps company-wide.","tag":"ENT","keywords":["organisation","parent workspace","member workspaces","sub-workspaces","multiple workspaces","add workspace to organization","managed by org","settings locked","publish to company","cross-workspace","enterprise organization"],"href":"/features/organizations"},"pages":[{"title":"Set up organization identity: domains, SSO, and SCIM","sidebarTitle":"Organization identity","description":"Verify domains, connect SSO, and provision members once for every workspace in your organization, and decide which workspaces the organization manages.","tag":"ENT","keywords":["organization SSO","cross-workspace SCIM","group to workspace mapping","org managed identity","identity and SSO","multiple workspaces SSO","shared SSO","org domains","org SCIM"],"href":"/features/organization-identity"},{"title":"Manage people across the workspaces in your organization","sidebarTitle":"Organization people","description":"See every member, role, and workspace assignment in your organization from one People page, add or remove people across workspaces, and manage org admins.","tag":"ENT","keywords":["organization people","org members","workspace assignments","offboarding","remove from all workspaces","cross-workspace members","org roster","bulk remove members"],"href":"/features/organization-people"}]},{"group":"Access","pages":[{"title":"Manage workspace members from the People tab","sidebarTitle":"People","description":"Manage workspace members, invitations, roles, access requests, and per-member credit limits.","keywords":["people","workspace members","members","invitations","invite members","invite link","roles","owner","primary owner","transfer primary ownership","transfer workspace ownership","admin","editor","viewer","collaborator","external collaborators","access requests","workspace access requests","project access requests","role upgrade request","ask for admin access","promote myself","credit limit","per-member credit limit","export members","member list export","bulk actions","remove member","change role","SSO provisioning","SCIM","JIT provisioning","verified email provisioning"],"href":"/features/people"},{"title":"Groups","description":"Organize workspace members into groups for granular control over project access and published app visibility.","href":"/features/groups"},{"group":"Identity","root":{"title":"Manage workspace identity and user provisioning","sidebarTitle":"Workspace identity","description":"Control how your team authenticates and joins your workspace: verified domains, SSO, enforced login, and automatic user provisioning.","keywords":["workspace identity","identity tab","identity settings","user provisioning","SSO login","JIT provisioning","just-in-time provisioning","verified email sign-up","domain JIT","add existing users","enforce SSO","session duration","SCIM","domain lock","require SSO","block workspace creation","enterprise-managed authentication","Lovable MCP from Claude"],"href":"/features/workspace-identity"},"pages":[{"title":"Verify a domain for your workspace","sidebarTitle":"Verified domains","description":"Prove ownership of your company's email domain with a DNS record to unlock SSO, automatic user provisioning, SCIM, and branded app URLs.","keywords":["verified domain","verify domain","domain verification","DNS TXT record","lovable_verification","workspace identity","SSO domain","email domain","domain JIT","verified email sign-up","user provisioning","identity settings","domain lock","require SSO","block workspace creation"],"href":"/features/verified-domains"},{"title":"Set up workspace single sign-on (SSO)","sidebarTitle":"Workspace SSO","description":"Connect Okta, Auth0, Microsoft Entra ID, or any OIDC/SAML 2.0 provider to enable secure, centralized authentication for your workspace.","keywords":["single sign-on","sso","SSO setup","SSO configuration","SSO integration","enterprise SSO","enforce SSO","identity provider","OIDC","SAML","Okta SSO","Auth0 SSO","Microsoft Entra ID SSO","Azure AD SSO","Google Workspace SSO","logging in twice","SSO group mapping","group claims","group-based provisioning","group restriction","IdP groups","IdP-initiated SSO","IdP-initiated SAML"],"href":"/features/business/sso"},{"title":"Set up enterprise-managed authentication","sidebarTitle":"Enterprise-managed authentication","description":"Let your team use Lovable from Claude through Okta single sign-on, without a separate Lovable sign-in. Configure access, test it, and disable it.","keywords":["enterprise-managed authorization","ID-JAG","Cross App Access","managed authorization"],"href":"/features/enterprise-managed-auth"},{"title":"Set up SCIM user provisioning","sidebarTitle":"SCIM provisioning","description":"Configure SCIM provisioning to automatically create, update, and remove users in Lovable using your identity provider. Manage user access, roles, and lifecycle centrally with Okta, Microsoft Entra ID, and other SCIM 2.0 providers.","tag":"ENT","keywords":["SCIM","SCIM provisioning","user provisioning","user deprovisioning","identity provider","IdP","SSO","Okta SCIM","Microsoft Entra ID SCIM","Azure AD SCIM","identity management","access management","enterprise SSO","group push","group role mapping"],"href":"/features/business/scim"}]},{"title":"Create and manage API keys","sidebarTitle":"API keys","description":"Create, scope, and revoke workspace API keys (access tokens) for the Lovable API, set per-key credit limits, and restrict keys to approved IP addresses.","keywords":["API key","access token","Lovable API","scopes","revoke","credit limit","IP allowlist","IP allowlists required"],"href":"/features/api-keys"},{"title":"Connect apps to Lovable with OAuth","sidebarTitle":"OAuth clients","description":"Register OAuth clients to connect your apps to Lovable, choose scopes, request verification for sensitive scopes, and manage client credentials.","keywords":["Lovable OAuth","OAuth clients","connect app to Lovable","API keys and OAuth","client secret","OAuth scopes","PKCE"],"href":"/features/oauth-clients"}]},{"group":"Security","pages":[{"title":"Privacy \u0026 security settings","sidebarTitle":"Privacy \u0026 security","description":"Manage workspace-wide controls for member access, project publishing, external sharing, connected tools, security scans, and data protection.","keywords":["privacy and security","workspace privacy","workspace security","workspace security settings","security and compliance","access and membership","default project access","project visibility","restricted projects","workspace invitations","restrict workspace invitations","invite links","workspace discovery","workspace access requests","allow editors to transfer projects","project transfers","external collaborator access","external collaborators","public member profiles","hide member profiles","member profile visibility","enterprise member profiles","enforce SSO","single sign-on","require two-factor authentication","require MFA","MFA enforcement","workspace 2FA requirement","mandatory 2FA","publishing permissions","default website access","default published app access","workspace-only publishing","public publishing","who can publish externally","publish externally","external invites","disable external invites","who can receive external invites","verified-domain emails only","external website viewers","block publishing with critical findings","critical security findings","require approval to publish","app login methods","security automation","auto-fix security issues","allow public preview links","public preview links","share preview links","cross-project sharing","cross-project referencing","mcp servers access","model context protocol","allow local mcps","local mcp servers","data protection","sensitive data scanning","pii scanning","personally identifiable information","chat send protection","block public storage buckets","public storage buckets","default hosting region","where new projects are hosted","default cloud region","data residency","region pin","smart regions","country-specific regions","extended-retention models","zero data retention","data retention models","abandoned projects","abandonment protection","protected projects","restrict Lovable backend services","require API key IP allowlists","approve Lovable Cloud","block Lovable Cloud","connector requests policy","let editors request connectors"],"href":"/features/privacy-and-security-settings"},{"title":"Workspace policies","description":"Set Enterprise policies that block publishing or require approval for public apps, connectors, and Lovable backend services, and let editors request connectors.","keywords":["publish approval","approval workflow","approval request","require approval to publish","block publishing","publishing governance","who can publish externally","block publishing with PII","restrict publishing with unresolved PII findings","external collaborators publish","block external collaborators from publishing","require approval for external collaborators to publish","block publishing from unverified domains","enterprise governance","approve Lovable Cloud","block Lovable Cloud","cloud provisioning approval","request a connector","let editors request connectors"],"href":"/features/workspace-policies"},{"title":"Action center","description":"Approve or deny requests and review security findings across your workspace in the Lovable Action center: assign owners, unpublish inactive apps, check spend.","keywords":["approve publish request","deny publish request","approve Lovable Cloud","backend services request","credit usage spike","projects with no owner","apps lost their owner","security review","publish requests inbox","inactive projects","request a connector","decline connector request"],"href":"/features/action-center"},{"title":"EU inference","sidebarTitle":"EU inference","description":"Keep an Enterprise workspace's AI model requests on model endpoints in the European Union, while you build and for the AI features in your published apps.","keywords":["EU AI processing","AI processing location","AI model region","GDPR","enterprise privacy controls","EU data protection","model not available in the EU"],"tag":"ENT","href":"/features/eu-inference"},{"group":"Security center","root":{"title":"Workspace security center","sidebarTitle":"Workspace security center","description":"Monitor security findings, scan coverage, scheduled scans, secrets, and dependency risks across every project in your workspace.","keywords":["security center","workspace security","security dashboard","dependency vulnerabilities","scan coverage","security management","risk management","secrets overview","api keys","secret auditing","CSV export","security export"],"href":"/features/security-center"},"pages":[{"title":"Security insights","description":"Govern your Lovable workspace by identifying projects that need attention, with workspace-wide security, privacy, ownership, usage, and activity signals organized by review priority.","keywords":["security insights","workspace insights","workspace governance","AI governance","project governance","review priority","project review","portfolio security view","workspace security dashboard","security center","PII findings","sensitive data findings","abandoned projects","orphaned projects","projects with no owner","project inventory","enterprise security","CSV export"],"sidebarTitle":"Security insights","href":"/features/security-insights"}]},{"title":"Audit logs","description":"Monitor workspace activity with Enterprise audit logs. Filter by action, member, resource, or time range to review events such as membership changes, project actions, authentication events, and workspace settings or configuration changes.","tag":"ENT","keywords":["audit logs","enterprise audit logs","workspace audit logs","audit trail","activity logs","workspace activity","administrative activity","access monitoring","compliance logging"],"href":"/features/audit-logs"},{"group":"Data exports","root":{"title":"Export audit logs to your SIEM or cloud storage","sidebarTitle":"Data exports","description":"Schedule exports of workspace audit logs to Amazon S3, Google Cloud Storage, Azure Blob Storage, Splunk, or Azure Log Analytics. Lovable delivers new data every hour or every 3 hours.","tag":"ENT","keywords":["data exports","data export","log export","audit log export","SIEM","SIEM integration","log forwarding","log streaming","Splunk","Splunk HEC","Azure Log Analytics","Microsoft Sentinel","Amazon S3","Google Cloud Storage","GCS","Azure Blob Storage","compliance logging","log retention"],"href":"/features/data-exports"},"pages":[{"title":"Export Lovable logs to Amazon S3","sidebarTitle":"Amazon S3","description":"Set up a scheduled data export from Lovable to an Amazon S3 bucket. Lovable assumes an IAM role through web identity federation and writes gzipped JSON Lines files.","tag":"ENT","keywords":["Amazon S3","S3 export","AWS","IAM role","web identity federation","audit log export to S3","log export","Athena","data exports"],"href":"/features/data-exports-amazon-s3"},{"title":"Export Lovable logs to Azure Blob Storage","sidebarTitle":"Azure Blob Storage","description":"Set up a scheduled data export from Lovable to an Azure Blob Storage container. Lovable signs in with a Microsoft Entra federated credential and writes gzipped JSON Lines files.","tag":"ENT","keywords":["Azure Blob Storage","Azure storage export","blob container","Microsoft Entra","federated credential","workload identity federation","audit log export to Azure","log export","data exports"],"href":"/features/data-exports-azure-blob-storage"},{"title":"Export Lovable logs to Azure Log Analytics","sidebarTitle":"Azure Log Analytics","description":"Set up a scheduled data export from Lovable to an Azure Log Analytics workspace. A setup script creates a table and data collection rule for each source.","tag":"ENT","keywords":["Azure Log Analytics","Azure Monitor","Microsoft Sentinel","logs ingestion API","data collection rule","DCR","custom table","KQL","Microsoft Entra","federated credential","SIEM","audit log export to Azure","data exports"],"href":"/features/data-exports-azure-log-analytics"},{"title":"Export Lovable logs to Google Cloud Storage","sidebarTitle":"Google Cloud Storage","description":"Set up a scheduled data export from Lovable to a Google Cloud Storage bucket. Lovable writes gzipped JSON Lines files with short-lived tokens limited to your bucket and workspace path.","tag":"ENT","keywords":["Google Cloud Storage","GCS export","GCS bucket","IAM condition","uniform bucket-level access","audit log export to GCS","log export","BigQuery","data exports"],"href":"/features/data-exports-google-cloud-storage"},{"title":"Export Lovable logs to Splunk","sidebarTitle":"Splunk","description":"Set up a scheduled data export from Lovable to Splunk Cloud or Splunk Enterprise through the HTTP Event Collector (HEC). Lovable sends one JSON event per row with fields to search and remove duplicates.","tag":"ENT","keywords":["Splunk","Splunk HEC","HTTP Event Collector","Splunk Cloud","Splunk Enterprise","SIEM","SIEM integration","audit log export to Splunk","log forwarding","data exports"],"href":"/features/data-exports-splunk"}]},{"title":"Sensitive data scanning","description":"Detect and manage personally identifiable information across chat messages, file uploads, project chat history, and the app's built-in database and storage.","keywords":["pii scanning","sensitive data scanning","chat send protection","data loss prevention","DLP","pii detection warnings","redact pii","enterprise privacy controls","workspace privacy settings","data privacy"],"tag":"ENT","href":"/features/sensitive-data-scanning"},{"title":"Manage training data and privacy","description":"Control whether your data is used to train Lovable's AI models, and understand how Lovable handles your personal data.","sidebarTitle":"Training data and privacy","keywords":["data opt-out","ai model training","training data","data collection opt out","privacy","personal data","september 9 2026","lovable customer data","training data exclusion"],"href":"/features/business/data-opt-out"}]},{"group":"Your account","root":{"title":"Account settings","description":"Manage your personal identity, profile, preferences, and account security on Lovable from the Account settings dialog.","keywords":["Lovable account settings","profile settings","user profile","username settings","change name","profile picture","avatar","profile visibility","login methods","Linked accounts","SSO login","single sign on","SAML OIDC","two factor authentication","2FA","account security","log out everywhere","sessions","revoke sessions","agent permissions","chat settings","chat suggestions","notification sound","personalized emails","marketing personalization opt out","skills","LinkedIn skills","Lovable profile page","data collection opt out","AI model training opt-out","privacy settings","devices and apps","this device"],"href":"/introduction/lovable-account-settings"},"pages":[{"title":"Two-factor authentication (2FA)","description":"Learn how to set up and manage two-factor authentication (2FA) on your Lovable account, and give your account an extra layer of security.","keywords":["two-factor authentication","2FA","account security","multi-factor authentication","MFA","authentication code","verification code","authenticator app","SMS verification","login security","account protection","Lovable security","Google Authenticator","Microsoft Authenticator","Authy","1Password","security banner","Enable 2FA","SMS codes not available"],"href":"/introduction/two-factor-authentication-2-fa"},{"title":"Delete account","description":"Permanently delete your Lovable account, with a 30-day grace period to change your mind.","keywords":["delete account","account deletion","remove Lovable account","close account","account removal process","30 day grace period","cancel account deletion","recover account","soft delete","permanent account deletion","delete user data","account settings delete","workspace ownership transfer","cancel deletion","Lovable account settings"],"href":"/introduction/delete-account"}]}]},{"group":"Plans \u0026 billing","icon":"credit-card","pages":[{"title":"Subscription plans","description":"Compare the Free, Pro, Business, and Enterprise subscription plans, see which features and credit tiers each plan includes, and find the student and teacher discount.","keywords":["subscription plans","plans","pricing","plan comparison","subscription tiers","credit tiers","annual billing","monthly billing","student discount","education discount","email domain not recognized"],"href":"/introduction/subscription-plans"},{"title":"Change or cancel your subscription","description":"Upgrade or downgrade your plan or credit tier, switch between monthly and annual billing, or cancel your Lovable subscription, and see what happens to your credits and features afterward.","keywords":["cancel subscription","cancel plan","cancel Lovable","downgrade","downgrade to free","upgrade","upgrade plan","change plan","manage subscription","manage plan","annual billing","monthly billing","switch to annual","credit tier"],"href":"/introduction/manage-subscription"},{"title":"Invoices, payments, and billing details","sidebarTitle":"Invoices and billing","description":"Find and download your Lovable invoices and receipts, update your payment method, billing address, and tax details, redeem a gift card, and fix a failed payment.","keywords":["invoice","invoices","receipt","receipts","download invoice","billing","billing information","billing details","payment method","credit card","change credit card","payment history","tax id","gift card","coupon","payment failed","Stripe billing portal","charged more than the price","foreign transaction fee","accepted payment methods"],"href":"/introduction/invoices-and-billing"},{"title":"Credits and usage","description":"Understand how Lovable credits work: where credits come from, when they expire, what building, chat, Cloud, and AI usage cost, and how to check your balance.","keywords":["daily chat allowance","chat credits","daily chat credits","chat usage","chat pricing","chats pricing","chat mode pricing","chat messages","credit balance","usage details","build credits","run credits","Cloud usage","AI usage","credit expiry","rollover credits","monthly credits"],"href":"/introduction/credits-and-usage"},{"title":"Credit top-ups","description":"Buy more Lovable credits on Pro and Business with a one-time top-up, or set up auto top-up to add credits when your balance runs low.","keywords":["top up credits","recharge","buy credits","more credits","extra credits","top-up price","credits per top-up","payment failed","card declined","auto top-up paused"],"href":"/introduction/credit-top-ups"},{"title":"Referral program: share Lovable and earn credits","sidebarTitle":"Referral program","description":"Invite people to Lovable with your workspace invite link and earn up to 400 bonus credits for each person who subscribes to a Pro or Business plan.","keywords":["refer a friend","referal","invite friends","referral rewards","credits for inviting","invite link credits"],"href":"/introduction/referral-program"},{"title":"Usage limits and alerts","sidebarTitle":"Usage limits \u0026 alerts","description":"Set credit usage limits and low-balance alerts for your workspace, projects, members, groups, and access tokens. Get notified or block usage when a threshold is reached.","keywords":["usage limits","usage alerts","credit limits","spending limits","credit alerts","low balance alert","budget","credit caps","block usage","member credit limit","project credit limit","access token limit","view usage limits","limit increase request","percentage balance alert","approaching limit","connector limit","pause connectors"],"href":"/features/usage-limits-and-alerts"},{"title":"Low credit balance and out-of-credits recovery","sidebarTitle":"Low balance and recovery","description":"Understand the low credit balance warnings, prevent running out of credits, and get building and your apps running again when your workspace credits run out.","keywords":["no credits left","credits ran out","zero credits","running low on credits","credits almost gone","backend paused","Cloud paused","wake up","building stopped","insufficient credits","resume paused app","credit warnings"],"href":"/introduction/out-of-credits"}]},{"group":"Guides \u0026 reference","icon":"life-ring","pages":[{"group":"Guides","pages":[{"title":"How to build a real product with Lovable","sidebarTitle":"Idea to product","description":"Shape the idea, plan, design, build in small loops, add a backend, test, publish, and keep improving your app once people are using it.","keywords":["idea to product","from idea to app","how to build a product","build a real app","best practices","plan mode","knowledge file","project instructions","prompting tips","app development process","ship an app","lovable workflow","github sync","version history","design prompts"],"href":"/tips-tricks/from-idea-to-app"},{"title":"Launch your site on a custom domain","sidebarTitle":"Launch on a custom domain","description":"Go from a finished project to a live site on your own domain: publish, buy or connect a domain, wait for it to go live, test it, and help people find it.","keywords":["go live","launch website","own domain","point my domain to Lovable","domain setup","DNS setup","A record","TXT record","www redirect","primary domain","Google Search Console","site title","favicon"],"href":"/tips-tricks/launch-on-a-custom-domain"},{"title":"Prompting best practices","description":"Plan before you prompt, build by component, use real content, and apply design buzzwords to get consistent, high-quality results.","href":"/prompting/prompting-one"},{"title":"Prompt library","description":"Copy-paste prompts for the features people build most: authentication, dashboards, file uploads, payments, notifications, and AI, all built on the built-in backend.","keywords":["prompt library","example prompts","prompt templates","copy paste prompts","add authentication prompt","add payments prompt","ai app prompts","lovable prompts"],"href":"/prompting/prompting-library"},{"title":"Debug and improve your app","sidebarTitle":"Debug \u0026 improve","description":"Describe bugs so Lovable can fix them, investigate root causes in Plan mode, and improve a working app with codebase audits, performance checks, and careful changes.","keywords":["debugging","fix errors","error loop","root cause","codebase audit","performance audit","try to fix","debug prompts","blank screen"],"href":"/prompting/prompting-debugging"},{"title":"Edit Google Docs, Sheets, and Slides in Lovable","sidebarTitle":"Edit Google files","description":"Add lightweight project instructions for embedding editable Google Docs, Sheets, and Slides files in Lovable previews, with connector setup guidance and iframe URL patterns.","keywords":["Google Docs in Lovable","Google Sheets in Lovable","Google Slides in Lovable","editable Google iframe","Google Workspace knowledge","Google Workspace instructions","Google Workspace connectors"],"href":"/tips-tricks/google-workspace-editing"}]},{"title":"FAQ","description":"Common questions about Lovable: what it builds, what each feature does, what it costs, how your account works, and how Lovable handles security and your data.","related":false,"keywords":["lovable faq","frequently asked questions","what is lovable","is lovable free","lovable plans","cancel subscription","refund","invoices","hide lovable badge","export code","change email","transfer project","which model does lovable use","tech stack","mobile apps","gdpr","data training","who owns the code","who founded lovable","who owns lovable","where is lovable based"],"href":"/introduction/faq"},{"title":"Glossary","description":"Definitions of Lovable-specific terms, features, and the general web development concepts you'll encounter in the documentation.","href":"/glossary"},{"title":"Video tutorials and courses","sidebarTitle":"Videos and courses","description":"Watch short video walkthroughs of Lovable features, follow a guided learning path in the Lovable Academy, or browse tutorials from the Lovable community.","keywords":["lovable academy","lovable 101","youtube tutorials","learn lovable","walkthrough videos","learning path","lovable course"],"href":"/introduction/video-tutorials"},{"title":"Support policy","description":"How to get help with Lovable: self-help resources, what support covers on each plan, how to contact the support team, response times, and enterprise support levels.","keywords":["contact support","customer support","help","support ticket","SLA","response time","priority support","enterprise support","Discord","status page","refund","cancel subscription","invoice","takedown","appeal","account disabled","account banned","site down","app not working"],"href":"/introduction/support-policy"}]}]},{"tab":"API Reference","groups":[{"group":"Lovable API","pages":[{"title":"API basics","description":"All the basics to get started with the Lovable API.","sidebarTitle":"Introduction","keywords":["Lovable API","base URL","rate limits","pagination","API Reference"],"href":"/api-reference/introduction"},{"title":"API changelog","description":"Track stable versions and changes to the Lovable API.","keywords":["Lovable API changelog","API versions","stable version","Lovable-Version","API changes"],"href":"/api-reference/changelog"},{"group":"Endpoints","pages":[{"group":"Workspaces","pages":[{"title":"List workspaces","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns workspaces accessible to the authenticated client, with cursor pagination. Workspaces are ordered by join date, oldest first. A workspace-scoped API key returns only its workspace. Member details, including roles, are on GET /v1/workspaces/{workspace_id}/members. The num_projects count is eventually consistent and may not immediately reflect project creation or deletion.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces","href":"/api-reference/workspaces/list-workspaces","autogeneratedByOpenApi":true},{"title":"Get workspace","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns workspace details, security and publishing policies, seat count, billing period, and default member credit limit. Usage fields are null without permission to view workspace usage. Member details, including roles, are on GET /v1/workspaces/{workspace_id}/members. The num_projects count is eventually consistent and may not immediately reflect project creation or deletion.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}","href":"/api-reference/workspaces/get-workspace","autogeneratedByOpenApi":true},{"title":"List workspace folders","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns the workspace's folders, sorted by name then id. Each project belongs to at most one folder; match a folder's id against the folder_id of GET /v1/projects and GET /v1/workspaces/{workspace_id}/security-center/insights/projects to group projects by folder, and filter either list with folder_id or is_in_folder. Restricted folders are returned only when the caller created them, was given access to them, or may manage every member's restricted folders. Reads are eventually consistent: recent changes may not appear immediately. Retry the read with backoff if an expected change is missing.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/folders","href":"/api-reference/workspaces/list-workspace-folders","autogeneratedByOpenApi":true}]},{"group":"Members \u0026 access","pages":[{"title":"List project collaborators","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns users individually granted access to this project, with their access level. Access through groups, folders, or a workspace role is not listed, and the owner appears only when they also hold an explicit grant. Excludes pending invitations to email addresses without a Lovable account. Each user_id matches a user_id from GET /v1/workspaces/{workspace_id}/members, where users added only to projects have the role external_collaborator. A newly added collaborator may not appear there immediately.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/collaborators","href":"/api-reference/members-access/list-project-collaborators","autogeneratedByOpenApi":true},{"title":"List workspace groups","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns the workspace's groups, sorted by name. Use a group's id as the id of a type \"group\" audience_targets entry when publishing a project with audience \"custom\" via POST or PATCH /v1/projects/{project_id}/publish.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/groups","href":"/api-reference/members-access/list-workspace-groups","autogeneratedByOpenApi":true},{"title":"List workspace members","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns accepted workspace members with user_id, type, and name. The name is the stored display name, or null when unavailable. Filter with a repeated role, scim_managed=true|false, and query. Sort with sort_by plus sort_order; with a search query, results default to best matches first, otherwise they are ordered by role precedence, then most recently joined. Cursors are pinned to the filters and sort they were issued under; presenting one with different parameters returns 400. Reads are eventually consistent: recent changes may not appear immediately. Retry the read with backoff if an expected change is missing.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/members","href":"/api-reference/members-access/list-workspace-members","autogeneratedByOpenApi":true},{"title":"Get workspace member","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns an active workspace member's profile and join and invitation dates. name is the stored display name, or null when unavailable. Pass the public user UUID returned as user_id by GET /v1/workspaces/{workspace_id}/members. Unknown users and missing or non-active memberships return 404. Reads are eventually consistent: recent changes may not appear immediately. Retry the read with backoff if an expected change is missing.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/members/{user_id}","href":"/api-reference/members-access/get-workspace-member","autogeneratedByOpenApi":true}]},{"group":"Projects","pages":[{"title":"List projects","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns projects across the selected workspaces in one cursor-paginated list, sorted by last edited time descending then project ID ascending. Projects without a last edit use their update time for ordering; projects with neither sort last. Repeat workspace_id to select up to 10 workspaces. Every selected workspace must pass authorization; any failure rejects the whole request. Workspace-scoped API keys remain limited to their own workspace. Cursors are bound to the selected workspace set and filters. Reads are eventually consistent: recent changes may not appear immediately. Retry the read with backoff if an expected change is missing.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects","href":"/api-reference/projects/list-projects","autogeneratedByOpenApi":true},{"title":"Get project","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns project details.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}","href":"/api-reference/projects/get-project","autogeneratedByOpenApi":true},{"title":"Delete project","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nDeletes a project. Where trash is available the project can be restored from the Lovable editor; otherwise the deletion is permanent and custom domains are disconnected immediately. Deleting a project that is already deleted returns 404 with type project_not_found, so a client retrying a delete whose outcome it does not know should treat that 404 as success.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest delete /v1/projects/{project_id}","href":"/api-reference/projects/delete-project","autogeneratedByOpenApi":true},{"title":"Update project","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nUpdates project sharing or the human-readable name. The description is generated by the agent and cannot be edited through this endpoint. Omitted fields keep their current values. This does not change access to the published app; use PATCH /v1/projects/{project_id}/publish for that.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest patch /v1/projects/{project_id}","href":"/api-reference/projects/update-project","autogeneratedByOpenApi":true},{"title":"Create embed URL","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nCreates a preview URL valid for one hour that can be loaded in an iframe on one exact HTTPS origin. Visitors do not need a Lovable login. It shows the project's built preview; it does not grant access to the editor or the published app.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest post /v1/projects/{project_id}/embed-url","href":"/api-reference/projects/create-embed-url","autogeneratedByOpenApi":true}]},{"group":"Deploy \u0026 domains","pages":[{"title":"Publish project","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nBuilds and deploys the project. When the workspace blocks publishing on critical security findings, the quick security scan runs on the version being published first, and unresolved findings fail the request with 400 security_critical_findings. Returns 202 with the Deployment representation, status running, and null url and error fields; poll GET /v1/projects/{project_id}/publish/{deployment_id} until deployment finishes. Optionally set audience to choose who can open the published app; project reads report it as publish_audience. Omit audience to keep the current setting. Audience changes apply to the currently published version immediately, before the new deployment finishes. To change access settings without rebuilding, use PATCH /v1/projects/{project_id}/publish. To take the app offline, use DELETE /v1/projects/{project_id}/publish.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest post /v1/projects/{project_id}/publish","href":"/api-reference/deploy-domains/publish-project","autogeneratedByOpenApi":true},{"title":"Unpublish project","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nTakes the published app offline. Audience and visibility settings are retained and apply again on the next POST /v1/projects/{project_id}/publish. Returns 204 whether or not the app was online, so a repeated call is safe.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest delete /v1/projects/{project_id}/publish","href":"/api-reference/deploy-domains/unpublish-project","autogeneratedByOpenApi":true},{"title":"Update publish settings","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:write`\n\nChanges published app access without rebuilding the app. Set audience to public, workspace, or custom; project reads report it as publish_audience. With a custom audience, audience_targets replaces group and user grants and removes workspace-wide access; organization access and email invitations managed in the UI are preserved. Changes take effect immediately. Where an enforced workspace publishing policy decides publishes, a published app that is not public becomes public only through a publish, which also ships the latest saved version: set audience public on POST /v1/projects/{project_id}/publish, since this route answers 409 publish_visibility_requires_publish. A published app gets the same checks as POST /v1/projects/{project_id}/publish. Making it public can fail with 400 security_critical_findings or pii_findings_unresolved. Making it private can fail with 400 app_mcp_unauthenticated_private. Returns the resolved audience and its targets. Read GET /v1/projects/{project_id} for is_published, publish_audience, and publish_audience_targets. To build and publish a new version, use POST /v1/projects/{project_id}/publish. To take the app offline, use DELETE /v1/projects/{project_id}/publish.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest patch /v1/projects/{project_id}/publish","href":"/api-reference/deploy-domains/update-publish-settings","autogeneratedByOpenApi":true},{"title":"Get publish status","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns the status of an async publish started with POST /v1/projects/{project_id}/publish, keyed by the id it returned. Poll until deployment succeeds (url is set) or fails (error_message explains the failure). Poll no more than once every 2 seconds and honor Retry-After on 429 responses.\n\nOn failure, use error_class to choose the next action.\n\n| error_class | Action |\n| --- | --- |\n| transient | Retry publishing with backoff and a bounded retry limit. |\n| code | Fix the app code or SQL, then publish again. |\n| configuration | Fix configuration committed in the project, such as an oversized file, then publish again. |\n| data | Review the migration against production data. Obtain human approval before changing data, then publish again. |\n| integration | Repair external credentials, quota, or the connected service, then publish again. |\n| policy | Ask the workspace administrator to lift the blocking policy or approve the publish. |\n| internal | Contact Lovable support with the deployment ID. |\n\nIf error_class is null or unrecognized, show error_message and contact support instead of automatically retrying.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/publish/{deployment_id}","href":"/api-reference/deploy-domains/get-publish-status","autogeneratedByOpenApi":true}]},{"group":"Security \u0026 governance","pages":[{"title":"List personal data findings","description":"**Plan:** `Enterprise`\n\n**Scope:** `projects:read`\n\nReturns findings of personally identifiable information (PII) in the project, newest first, including open, ignored, and fixed findings. Personal data detection must be enabled for the workspace; otherwise this endpoint returns 404.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/pii-labels","href":"/api-reference/security-governance/list-personal-data-findings","autogeneratedByOpenApi":true},{"title":"List security scans","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns the project's security scans ordered by start time, newest first. Use GET /v1/projects/{project_id}/security-scans/{scan_id}/findings to retrieve findings.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/security-scans","href":"/api-reference/security-governance/list-security-scans","autogeneratedByOpenApi":true},{"title":"Get security scan","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns a security scan's status, timing, and requested checks. Findings are available from GET /v1/projects/{project_id}/security-scans/{scan_id}/findings.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/security-scans/{scan_id}","href":"/api-reference/security-governance/get-security-scan","autogeneratedByOpenApi":true},{"title":"List security scan findings","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns a page of findings in the scan snapshot, including results reused from earlier scans and findings marked fixed or ignored. Findings are ordered by scanner_name, ascending, with a stable order within each scanner. Follow pagination.next_cursor until pagination.has_more is false to retrieve the complete snapshot.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/security-scans/{scan_id}/findings","href":"/api-reference/security-governance/list-security-scan-findings","autogeneratedByOpenApi":true},{"title":"Get workspace security insights","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nPrioritize security reviews across your workspace. Findings include public apps with security errors, unresolved personal data detections, projects shared with external collaborators, and projects whose owner is no longer an active workspace member.\n\nReturns workspace project and membership counts, project review priorities, and finding types with matching project counts. Requires Security Center access. The review_priority filter applies only to findings; summary counts remain workspace-wide. Finding types requiring personal data detection access are omitted when that feature is unavailable. Project and membership data is eventually consistent and may not immediately reflect recent changes.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/security-center/insights","href":"/api-reference/security-governance/get-workspace-security-insights","autogeneratedByOpenApi":true},{"title":"List workspace security project inventory","description":"**Plan:** `Enterprise`\n\n**Scope:** `workspaces:read`\n\nReturns workspace projects with review priorities, security finding counts, activity counts, and publishing details. Use GET /v1/projects/{project_id}/security-scans/{scan_id}/findings for individual findings. Supports search and filters. By default, projects are ordered by most recently edited, or search relevance when query is set. Project and membership data is eventually consistent and may not immediately reflect recent changes.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/security-center/insights/projects","href":"/api-reference/security-governance/list-workspace-security-project-inventory","autogeneratedByOpenApi":true}]},{"group":"Analytics","pages":[{"title":"Get project analytics","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns website traffic for a published project over a date range as a time series. Date ranges are limited to 365 days, or 31 days with one-hour buckets. Some projects retain analytics for 90 days; older buckets are returned with zero values.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/analytics","href":"/api-reference/analytics/get-project-analytics","autogeneratedByOpenApi":true},{"title":"Get project analytics breakdowns","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns the top pages, referring domains, device types, and visitor countries for a published project over a range of complete UTC calendar dates, up to 10 items each. Date ranges are limited to 365 days. Some projects retain analytics for 90 days; older days contribute no visitors.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/analytics/breakdowns","href":"/api-reference/analytics/get-project-analytics-breakdowns","autogeneratedByOpenApi":true},{"title":"Get project realtime analytics","description":"**Plan:** `Business or higher`\n\n**Scope:** `projects:read`\n\nReturns visitor counts for a published project over the last 30 minutes in one-minute buckets, plus the number of visitors active in the last 5 minutes.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/projects/{project_id}/analytics/realtime","href":"/api-reference/analytics/get-project-realtime-analytics","autogeneratedByOpenApi":true},{"title":"Get workspace analytics","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns website traffic time series for the workspace, including historical traffic from projects that have since been deleted. The response covers the requested date range without pagination. Date ranges are limited to 365 days, or 31 days with hourly granularity.","deprecated":null,"version":null,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=rest get /v1/workspaces/{workspace_id}/analytics","href":"/api-reference/analytics/get-workspace-analytics","autogeneratedByOpenApi":true}]}]},{"group":"Early access","pages":[{"group":"Credits","pages":[{"title":"Get available credits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns one workspace balance of remaining Lovable credits from subscriptions, top-ups, commitments, and bonuses. Excludes daily free credits, product allowances, and legacy Cloud/AI dollar wallets. The amount is an exact decimal string. Spending limits are reported separately and can still block usage.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/balance","href":"/api-reference/flagged/credits/get-available-credits","autogeneratedByOpenApi":true},{"title":"List balance alerts","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns workspace balance notifications, including disabled configured alerts. Threshold is either exact decimal credits or a percentage of eligible granted credits. Managed auto-top-up rules are excluded. Filters preserve the existing funding selection. Results are ordered by creation time descending, then ID descending; each page reflects current data.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/balance/alerts","href":"/api-reference/flagged/credits/list-balance-alerts","autogeneratedByOpenApi":true},{"title":"Set a balance alert","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a workspace balance alert with the same usage category and threshold. Threshold is exactly one positive decimal credits or percent value; percent supports two fractional digits from 0.01 to 99.99 and uses eligible granted credits as its denominator. Notifications fire on crossing down to or below the threshold. Email and in-app notifications are automatic; notification settings cannot be supplied. Optional filters select a usage category and exclude grant kinds or funding categories. Requires the credit-limit creation feature. Managed auto-top-up remains in billing settings. Balance alerts have no expiry; expires_at is invalid in writes. Returns 200. After a timeout, inspect the alerts collection before retrying; audit and evaluation side effects can repeat.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/balance/alerts","href":"/api-reference/flagged/credits/set-a-balance-alert","autogeneratedByOpenApi":true},{"title":"Delete a balance alert","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nSoft-deletes this workspace balance alert. Returns 204, or 404 when already absent. Managed auto-top-up rules cannot be deleted here. After a timeout, inspect the alerts collection before retrying. Idempotency keys are not supported.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged delete /v1/workspaces/{workspace_id}/credits/balance/alerts/{alert_id}","href":"/api-reference/flagged/credits/delete-a-balance-alert","autogeneratedByOpenApi":true},{"title":"Update a balance alert","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nChanges threshold or enabled. Omission keeps a value. Nonempty updates use email and in-app notifications automatically; notification settings cannot be supplied. Null values and expires_at are invalid. Funding filters are immutable. An authorized empty object returns the stored alert without writing or evaluating it. Managed auto-top-up rules cannot be changed here. After a timeout, inspect the alerts collection before retrying; nonempty retries can repeat audit and evaluation side effects.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged patch /v1/workspaces/{workspace_id}/credits/balance/alerts/{alert_id}","href":"/api-reference/flagged/credits/update-a-balance-alert","autogeneratedByOpenApi":true},{"title":"List workspace usage limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only workspace-wide usage limits and active read-only temporary overrides. Balance alerts and managed auto-top-up rules have separate APIs. Disabled stored rules remain visible. expires_at is read-only: the exclusive end of a temporary increase, or null for a permanent limit. When an increase expires, the original cap or default resumes. Sort with sort_by=created_at|credit_limit and sort_order=asc|desc; the default is source creation time descending, then ID descending. The catalog describes configuration, not whether an entity is currently blocked. Deleted rules and expired temporary overrides disappear between pages; new rules before the cursor require a fresh traversal.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits","href":"/api-reference/flagged/credits/list-workspace-usage-limits","autogeneratedByOpenApi":true},{"title":"Set a workspace usage limit","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits","href":"/api-reference/flagged/credits/set-a-workspace-usage-limit","autogeneratedByOpenApi":true},{"title":"List API-key defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/api-keys","href":"/api-reference/flagged/credits/list-api-key-defaults","autogeneratedByOpenApi":true},{"title":"Set API-key defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported. API-key limits do not support connectors.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/api-keys","href":"/api-reference/flagged/credits/set-api-key-defaults","autogeneratedByOpenApi":true},{"title":"List API-key limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/api-keys/{api_key_id}","href":"/api-reference/flagged/credits/list-api-key-limits","autogeneratedByOpenApi":true},{"title":"Set API-key limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported. API-key limits do not support connectors.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/api-keys/{api_key_id}","href":"/api-reference/flagged/credits/set-api-key-limits","autogeneratedByOpenApi":true},{"title":"List all usage limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns usage limits across all targets, including per-entity defaults and active read-only temporary overrides. Disabled rules remain visible; managed billing rules are excluded. Sort with sort_by=created_at|credit_limit and sort_order=asc|desc; the default is creation time descending, then ID descending. credit_limit compares exact configured amounts without converting periods. Sort parameters are pinned in the cursor. expires_at is response-only. Cursors are bound to this workspace and catalog.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/catalog","href":"/api-reference/flagged/credits/list-all-usage-limits","autogeneratedByOpenApi":true},{"title":"List group member limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns limits that apply separately to each member of this group. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/groups/{group_id}","href":"/api-reference/flagged/credits/list-group-member-limits","autogeneratedByOpenApi":true},{"title":"Set group member limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nApplies a usage limit separately to each member of this group. Creates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported. User and group member limits use Build credits; usage_category cannot be supplied.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/groups/{group_id}","href":"/api-reference/flagged/credits/set-group-member-limits","autogeneratedByOpenApi":true},{"title":"List project defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/projects","href":"/api-reference/flagged/credits/list-project-defaults","autogeneratedByOpenApi":true},{"title":"Set project defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/projects","href":"/api-reference/flagged/credits/set-project-defaults","autogeneratedByOpenApi":true},{"title":"List project limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/projects/{project_id}","href":"/api-reference/flagged/credits/list-project-limits","autogeneratedByOpenApi":true},{"title":"Set project limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/projects/{project_id}","href":"/api-reference/flagged/credits/set-project-limits","autogeneratedByOpenApi":true},{"title":"List user defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/users","href":"/api-reference/flagged/credits/list-user-defaults","autogeneratedByOpenApi":true},{"title":"Set user defaults","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported. User and group member limits use Build credits; usage_category cannot be supplied.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/users","href":"/api-reference/flagged/credits/set-user-defaults","autogeneratedByOpenApi":true},{"title":"List user limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns only limits for the target selected by this route. Defaults apply separately to each entity. Includes disabled stored rules and active read-only temporary increases for this target. expires_at is response-only; the original cap or default resumes after expiry. Scope filtering happens before pagination; cursors are bound to this workspace and target.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/limits/users/{user_id}","href":"/api-reference/flagged/credits/list-user-limits","autogeneratedByOpenApi":true},{"title":"Set user limits","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nCreates or updates a limit with the same route target, category and UTC day or month. POST preserves existing blocking behavior and configuration; PATCH changes enforcement. credit_limit is a positive whole-credit JSON integer from 1 to 9223372036. Notifications use email and in-app automatically and cannot be supplied. Requires the credit-limit creation feature. expires_at is response-only. Returns 200. Retries can repeat audit and evaluation side effects; idempotency keys are not supported. User and group member limits use Build credits; usage_category cannot be supplied.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged post /v1/workspaces/{workspace_id}/credits/limits/users/{user_id}","href":"/api-reference/flagged/credits/set-user-limits","autogeneratedByOpenApi":true},{"title":"Delete a usage limit","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nSoft-deletes the workspace usage limit and revokes its temporary overrides. Returns 204, or 404 when already absent. Temporary overrides and managed billing rules cannot be deleted here. After a timeout, inspect the collection before retrying. Idempotency keys are not supported.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged delete /v1/workspaces/{workspace_id}/credits/limits/{limit_id}","href":"/api-reference/flagged/credits/delete-a-usage-limit","autogeneratedByOpenApi":true},{"title":"Update a usage limit","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:write`\n\nChanges credit_limit, block_usage or enabled. Omission keeps a value. Nonempty updates use email and in-app notifications automatically; notification settings cannot be supplied. Null values and expires_at are invalid. Target, category and period are immutable. An authorized empty object returns the current rule without writing or evaluating it. Temporary overrides and managed billing rules are read-only here. After a timeout, inspect the collection before retrying; nonempty retries can repeat audit and evaluation side effects.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged patch /v1/workspaces/{workspace_id}/credits/limits/{limit_id}","href":"/api-reference/flagged/credits/update-a-usage-limit","autogeneratedByOpenApi":true},{"title":"Get credit usage total","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nReturns the exact total credits used in a UTC date range, including unattributed and unrecognized usage. Optional filters[user_id] and filters[project_id] restrict the total; both filters must match when supplied together. Reading anyone other than the calling user requires permission to view member usage. Defaults to the current month through today, with a maximum range of 366 days. Earlier runtime usage used a different billing model and is excluded; build usage covers the full requested period. Returns period and credits_used without grouping or pagination. Amounts are decimal strings with up to nine fractional digits; use decimal arithmetic.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/usage","href":"/api-reference/flagged/credits/get-credit-usage-total","autogeneratedByOpenApi":true},{"title":"List credit usage by project","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nLists workspace-wide per-project credit usage in a UTC date range. Sort by name or credits_used, ascending or descending, before cursor pagination; highest consumption is the default. Name sorting is case-insensitive and uses the current project display name, falling back to its name. Projects without attributed usage are omitted; unavailable names are null. The total includes unattributed usage without a synthetic project row. User and project filters are not supported. Requires permission to view member usage. Defaults to this month through today, with a maximum range of 366 days. Earlier runtime usage uses the same billing-model floor as the aggregate usage endpoint. Amounts are exact decimal strings.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/usage/projects","href":"/api-reference/flagged/credits/list-credit-usage-by-project","autogeneratedByOpenApi":true},{"title":"List credit usage by user","description":"**Plan:** `Business or higher`\n\n**Scope:** `workspaces:read`\n\nLists workspace-wide per-user credit usage in a UTC date range. Sort by name or credits_used, ascending or descending, before cursor pagination; highest consumption is the default. Name sorting is case-insensitive and falls back to active-member email. Users without attributed usage are omitted; unavailable names and emails are null. The total includes unattributed usage without a synthetic user row. User and project filters are not supported. Requires permission to view member usage. Defaults to this month through today, with a maximum range of 366 days. Earlier runtime usage uses the same billing-model floor as the aggregate usage endpoint. Amounts are exact decimal strings.","deprecated":null,"version":null,"groups":["public-credits-api","public-credits-api"],"noindex":true,"searchable":false,"openapi":"https://api.lovable.dev/v1/openapi.yaml?view=flagged get /v1/workspaces/{workspace_id}/credits/usage/users","href":"/api-reference/flagged/credits/list-credit-usage-by-user","autogeneratedByOpenApi":true}]}]}]},{"group":"Events \u0026 hooks","pages":[{"title":"Events \u0026 hooks","description":"Receive signed notifications when things happen in Lovable, or check actions before they proceed.","keywords":["webhooks","webhook","events","hooks","event notifications","callback URL"],"href":"/api-reference/events-and-hooks"},{"group":"Reference","pages":[{"group":"Hooks","pages":[{"title":"Before message submission","description":"Return a decision from your HTTPS endpoint before this action continues.","version":null,"deprecated":null,"hideApiMarker":true,"playground":"none","openapi":"https://api.lovable.dev/v1/openapi.yaml?view=webhooks webhook message.before_submit.v1","href":"/api-reference/hooks/message-before-submit-v1","autogeneratedByOpenApi":true}]},{"group":"Events","pages":[{"title":"Project created","description":"Receive a signed notification at your HTTPS endpoint.","version":null,"deprecated":null,"hideApiMarker":true,"playground":"none","openapi":"https://api.lovable.dev/v1/openapi.yaml?view=webhooks webhook project.created.v1","href":"/api-reference/events/project-created-v1","autogeneratedByOpenApi":true},{"title":"Project deleted","description":"Receive a signed notification at your HTTPS endpoint.","version":null,"deprecated":null,"hideApiMarker":true,"playground":"none","openapi":"https://api.lovable.dev/v1/openapi.yaml?view=webhooks webhook project.deleted.v1","href":"/api-reference/events/project-deleted-v1","autogeneratedByOpenApi":true},{"title":"Project published","description":"Receive a signed notification at your HTTPS endpoint.","version":null,"deprecated":null,"hideApiMarker":true,"playground":"none","openapi":"https://api.lovable.dev/v1/openapi.yaml?view=webhooks webhook project.published.v1","href":"/api-reference/events/project-published-v1","autogeneratedByOpenApi":true},{"title":"Project transferred to another workspace","description":"Receive a signed notification at your HTTPS endpoint.","version":null,"deprecated":null,"hideApiMarker":true,"playground":"none","openapi":"https://api.lovable.dev/v1/openapi.yaml?view=webhooks webhook project.workspace_transferred.v1","href":"/api-reference/events/project-workspace-transferred-v1","autogeneratedByOpenApi":true}]}]}]}]},{"tab":"Changelog","pages":[{"title":"Lovable changelog","sidebarTitle":"Changelog","rss":"true","description":"Lovable changelog and product updates. Stay up to date with new features, improvements, and bug fixes shipped in Lovable.","keywords":["lovable changelog","lovable product updates","lovable updates","lovable release notes","lovable new features","lovable platform updates","what's new in lovable","lovable cloud updates","lovable ai updates","lovable agent updates"],"href":"/changelog"}]}]},"basePath":"","title":"Set up workspace single sign-on (SSO) - Lovable Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}