Workspace admin settings - Lovable Documentation
Documentation Index Fetch the complete documentation index at: /llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. Workspace admin settings are the central place where workspace owners and admins manage the workspace and keep it organized, secure, and aligned with how your team works in Lovable. Workspace settings define shared configuration and defaults for members unless overridden at the project or member level.
Some changes, such as updates to verified OAuth clients, may require review before taking effect. To open them, click the workspace switcher at the top-left of the dashboard and select Workspace settings , or go to lovable.dev/settings . Use the sidebar to move between sections. Your personal settings, such as your profile, login methods, and two-factor authentication, are in the separate Account settings dialog, opened from your avatar at the bottom-left of the sidebar.
To find a setting quickly, start typing in the search box at the top of the settings sidebar. Results list the matching settings grouped by settings page, with the matching words highlighted. Select a result to open that setting. Lovable also matches common synonyms, so env finds Build secrets and sso finds Identity . You can also press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open the command palette and go to a settings section.
The available options depend on your pricing plan. Features that are plan-specific are noted in each section below. General workspace settings Manage the core identity of your workspace and workspace-level publishing options. Setting Description Avatar A workspace icon shown next to the workspace name across the app, including the workspace switcher. Name Your workspace display name (maximum 50 characters) shown throughout the interface.
Useful for distinguishing teams or business units. Workspace handle A unique public name for the workspace. Enable branded app URLs (Business and Enterprise) Publish apps under a workspace-branded subdomain derived from your verified domain. See Publish apps with branded URLs for more information. Transfer primary ownership Transfers the primary owner role, used for billing and domain claims, to another workspace member or to another Lovable account by email.
Only the current primary owner sees this setting. See Transfer primary ownership for more information. Leave workspace Removes your own access to the workspace. You cannot leave if you are the only owner or if this is your only workspace. See Leave a workspace for more information. Recently deleted projects Lists the deleted projects you can restore. Shown only while you have a deleted project you can restore. You can restore projects you own, and workspace owners can restore any deleted project in the workspace.
See Restore a deleted project for more information. Delete workspace Deletes the workspace, all its projects, and all member access, and cancels the workspace subscription. Only workspace owners can delete a workspace. On Free, Pro, and Business plans, owners can restore it within 60 days from Account settings → Account → Recently deleted workspaces . See Delete a workspace for more information. Billing and usage Manage your subscription, credits, billing settings, and workspace usage from Workspace settings → Plans & credit usage .
Lovable uses credits to measure and pay for credit-based usage across your workspace, including building your app, hosting and running it on Lovable, and powering AI features in deployed apps. Workspace owners and admins can upgrade or downgrade plans, switch billing cycles, change credit tiers, add credits with one-time top-ups, enable auto top-up, and manage billing history and payment settings. All other roles can open Plans & credit usage to see the current plan, credit balance, and usage, but billing controls are disabled for them.
They cannot initiate or approve charges against the workspace. For more information, see Subscription plans and Credits and usage . Usage limits & alerts Control credit spend with usage limits and low-balance alerts from Workspace settings → Usage limits & alerts , available on all paid plans. Workspace owners and admins can set credit thresholds for the workspace, projects, members, groups, and access tokens, and choose whether reaching a threshold sends a notification, blocks further usage, or both.
This includes the default member credit limit and per-member overrides. See Usage limits and alerts . Insights Use Workspace settings → Workspace → Insights to see how your workspace adopts Lovable: how many apps and builders are active, how many visits your published apps receive, which apps rank highest by visits, and which members contribute the most edits. You can export the full app list and the full builder list to CSV.
Insights is available on Business and Enterprise plans to workspace admins and owners. It reports adoption rather than security, and it complements the Security center , which reports which projects need attention. See Insights . Access Manage who has access to your workspace and how members are structured for collaboration. People The main place to manage workspace members. Workspace owners and admins can invite members, change roles, remove members, approve workspace and project access requests, and export the workspace member list as CSV.
You can also track per-member credit usage and set individual credit limits that override workspace defaults. See People . Groups Organize members into groups to simplify sharing and access control. Groups can be granted access to projects, folders, and published apps as a unit, reducing the need to manage permissions individually. Groups can also be synced from your identity provider using SCIM , so externally managed groups appear alongside manually created ones.
Group-level roles control who can manage the group itself. Each group can also have a default design system that its members get pre-selected when they create a project. Available on Business and Enterprise plans. See Groups . Identity Manage workspace identity and single sign-on (SSO). Configure SAML or OIDC providers, enforce SSO, set session duration, and control how users authenticate. You can also verify your organization’s email domains which are used for SSO and user provisioning.
Users can join your workspace automatically in three ways, controlled from the User provisioning section: through their first login with SSO ( SSO JIT , for just-in-time provisioning), by signing up with an email on one of your verified domains ( Verified email sign-up ), or through Add existing users , which brings existing Lovable accounts on your verified domains into the workspace in one step. SCIM-based sync from your identity provider is configured separately.
Provisioned users appear in the People tab, where you manage their roles and access. SCIM provisioning is available on Enterprise plans. All other features are available on Business and Enterprise plans. See Workspace identity , Verified domains , SSO , and SCIM . API keys & OAuth Open Workspace settings → API keys & OAuth to manage credentials for external integrations. Both sections require the workspace owner or admin role.
Section Purpose Plans Workspace access tokens Create API keys for management operations in this workspace. Choose scopes, expiration, credit limits, and IP restrictions, or revoke a key. Business and Enterprise OAuth clients Register OAuth clients to connect your apps to Lovable. Manage scopes, client secrets, and verification for sensitive scopes. All plans . Sensitive scopes require Business or Enterprise . See Manage workspace API keys and Connect apps to Lovable with OAuth .
Customization Standardize how projects are created and ensure consistency across teams. Instructions Define workspace-level instructions and context that Lovable uses across all projects. This
The rest of this page is on the live site.