Xano Documentation
  • 👋Welcome to Xano!
  • 🌟Frequently Asked Questions
  • 🔐Security & Compliance (Trust Center)
  • 🙏Feature Requests
  • 💔Known Issues
  • Before You Begin
    • Using These Docs
    • Where should I start?
    • Set Up a Free Xano Account
    • Key Concepts
    • The Development Life Cycle
    • Navigating Xano
    • Plans & Pricing
  • The Database
    • Designing your Database
    • Database Basics
      • Using the Xano Database
      • Field Types
      • Relationships
      • Database Views
      • Export and Sharing
      • Data Sources
    • Migrating your Data
      • Airtable to Xano
      • Supabase to Xano
      • CSV Import & Export
    • Database Performance and Maintenance
      • Storage
      • Indexing
      • Maintenance
      • Schema Versioning
  • 🛠️The Function Stack
    • Building with Visual Development
      • APIs
        • Swagger (OpenAPI Documentation)
      • Custom Functions
        • Async Functions
      • Background Tasks
      • Triggers
      • Middleware
      • Configuring Expressions
      • Working with Data
    • Functions
      • AI Tools
      • Database Requests
        • Query All Records
          • External Filtering Examples
        • Get Record
        • Add Record
        • Edit Record
        • Add or Edit Record
        • Patch Record
        • Delete Record
        • Bulk Operations
        • Database Transaction
        • External Database Query
        • Direct Database Query
        • Get Database Schema
      • Data Manipulation
        • Create Variable
        • Update Variable
        • Conditional
        • Switch
        • Loops
        • Math
        • Arrays
        • Objects
        • Text
      • Security
      • APIs & Lambdas
        • Realtime Functions
        • External API Request
        • Lambda Functions
      • Data Caching (Redis)
      • Custom Functions
      • Utility Functions
      • File Storage
      • Cloud Services
    • Filters
      • Manipulation
      • Math
      • Timestamp
      • Text
      • Array
      • Transform
      • Conversion
      • Comparison
      • Security
    • Data Types
      • Text
      • Expression
      • Array
      • Object
      • Integer
      • Decimal
      • Boolean
      • Timestamp
      • Null
    • Environment Variables
    • Additional Features
      • Response Caching
  • Testing and Debugging
    • Testing and Debugging Function Stacks
    • Unit Tests
    • Test Suites
  • CI/CD
  • File Storage
    • File Storage in Xano
    • Private File Storage
  • Realtime
    • Realtime in Xano
    • Channel Permissions
    • Realtime in Webflow
  • Maintenance, Monitoring, and Logging
    • Statement Explorer
    • Request History
    • Instance Dashboard
      • Memory Usage
  • Building Backend Features
    • User Authentication & User Data
      • Separating User Data
      • Restricting Access (RBAC)
      • OAuth (SSO)
    • Webhooks
    • Messaging
    • Emails
    • Custom Report Generation
    • Fuzzy Search
    • Chatbots
  • Xano Features
    • Snippets
    • Instance Settings
      • Release Track Preferences
      • Static IP (Outgoing)
      • Change Server Region
      • Direct Database Connector
      • Backup and Restore
      • Security Policy
    • Advanced Back-end Features
      • Xano Link
      • Developer API (Deprecated)
    • Metadata API
      • Master Metadata API
      • Tables and Schema
      • Content
      • Search
      • File
      • Request History
      • Workspace Import and Export
      • Token Scopes Reference
  • Xano AI
    • Building a Backend Using AI
    • Get Started Assistant
    • AI Database Assistant
    • AI Lambda Assistant
    • AI SQL Assistant
    • API Request Assistant
    • Template Engine
    • Streaming APIs
  • AI Tools
    • MCP Servers
      • Connecting Clients
      • MCP Functions
  • Xano Transform
    • Using Xano Transform
  • Xano Actions
    • What are Actions?
    • Browse Actions
  • Team Collaboration
    • Realtime Collaboration
    • Managing Team Members
    • Branching & Merging
    • Role-based Access Control (RBAC)
  • Agencies
    • Xano for Agencies
    • Agency Features
      • Agency Dashboard
      • Client Invite
      • Transfer Ownership
      • Agency Profile
      • Commission
      • Private Marketplace
  • Enterprise
    • Xano for Enterprise
    • Enterprise Features
      • Microservices
      • Tenant Center
      • Compliance Center
      • Security Policy
      • Instance Activity
      • Deployment
      • RBAC (Role-based Access Control)
      • Xano Link
  • Your Xano Account
    • Account Page
    • Billing
    • Referrals & Commissions
  • Troubleshooting & Support
    • Error Reference
    • Troubleshooting Performance
      • When a single workflow feels slow
      • When everything feels slow
      • RAM Usage
      • Function Stack Performance
    • Getting Help
      • Granting Access
      • Community Code of Conduct
      • Community Content Modification Policy
  • Special Pricing
    • Students & Education
    • Non-Profits
  • Security
    • Best Practices
Powered by GitBook
On this page
  • What is the Tenant Center?
  • How do I use the Tenant Center?
  • Creating New Tenants
  • Managing Tenants
  • Developing and Deploying Releases
  • RBAC: Tenant Center
  • RBAC Override
  • Best Practices

Was this helpful?

  1. Enterprise
  2. Enterprise Features

Tenant Center

Last updated 4 days ago

Was this helpful?

Quick Summary

The Tenant Center allows you to deploy your current workspace to multiple tenant environments. Think of your tenants as things like your stage or dev environment, and your users.

Each tenant is given a separate, isolated database and business logic, and you have the ability to selectively roll out new releases to one or more users simultaneously.

What is the Tenant Center?

The Tenant Center is designed to bring a more traditional workflow into Xano.

With Tenant Center, you can:

  • Easily manage separate development, stage, and production environments

  • Isolate your users into separate environments and roll out new releases to them selectively, or all at once

  • Organize your users into different groups to enable easier deployment of beta or exclusive features to select users

How do I use the Tenant Center?

Creating New Tenants

1

From your production / main development workspace, head to the Tenant Center from the left-hand navigation menu.

You'll find it located under the Marketplace (if you have it enabled) or the Library.

2

Click to create a new tenant.

Remember, tenants can be either your own stage and production environments, or actual separate user workspaces.

When adding a new tenant, you'll need to provide some basic information.

Parameter
Purpose
Example

Display Name

The name of the tenant workspace

Stage

Beta Customer ABC

Description

A description of the tenant workspace

"Staging changes for testing" "Workspace for customer ABC" "Beta access"

Tags

Apply tags to your tenants to easily filter them when searching and deploying new changes. Great for things like separating subscription tiers or tagging development-specific, internal tenants

This is optional, but highly recommended

dev customers build plan launch plan scale plan

A note on new tenant creation

Creating a new tenant does not deploy a release to it by default.


Managing Tenants

Edit Tenant

Change the settings applied when creating the tenant, such as the display name or description.

Deploy Release

Push a release to this specific tenant.

Impersonate

Access the tenant in its current state. Great for troubleshooting tenant specific issues and manual verification of pushed changes

Environment Variables

You can access and manage this tenant's environment variables from here. Use these to store things like API keys and other sensitive information to be used in that tenant's function stacks.

For example, if you are pushing a feature that calls OpenAI, and each tenant has their own OpenAI API key, you'd put that here and just make sure the name of the variable matches what you have in development.

Backups

Create or restore a backup of a tenant

Logs

Review logs directly associated with that tenant, such as release deployments, backups, and impersonations.


Developing and Deploying Releases

1

Make any changes you'd like to deploy in your development tenant. Push them to your stage tenant if you're using one.

Just make sure you're deploying from the tenant that contains your final, tested round of changes to push live to your tenants.

2

Use the tag selector to filter only the tenants you want to deploy to.

3

Give your new release a name, a description, and choose the source branch you'll be deploying changes from.

4

Select the tenants you'd like to deploy to.

You can click the checkbox at the top to select all currently shown tenants, or select individual tenants yourself.

5

Select the release to deploy and click the Deploy button at the bottom of the panel.

After deployment, the Release Stats table at the top will give you quick visibility into your deployment metrics.


RBAC: Tenant Center

The Tenant Center addon includes additional Role-based Access Control (RBAC) settings you can use to manage tenant-related permissions.

These permissions include:

  • Tenant Center - Enables access to the Tenant Center

  • Tenant Center RBAC - Enables access to Tenant Center RBAC settings

  • Tenant Center Logs - Enables access to the logs inside of the Tenant Center

  • Tenant Center Backup - Determines if a user can modify backup settings or perform backup/restore operations for tenants

  • Tenant Center Deploy - Determines if a user can deploy releases to tenants

  • Tenant Center Impersonate - Determines if a user can impersonate (access directly) a tenant

  • Tenant Center Secrets - Enables access to secrets for a tenant, such as Environment Variables

RBAC Override

From the Edit Tenant panel, you can enable RBAC Override. This option allows you to specify individual user permissions for each tenant by clicking RBAC at the top of the Tenant Center.


Best Practices

1

Tag your tenants

Using tags is crucial to quick and consistent work inside of the Tenant Center, especially as the number of tenants you have grows.

2

Follow a traditional deployment framework

3

Inform your users of upcoming deployments

In most cases, it's good practice to make sure your users are aware of upcoming changes.

4

Use backups

Tenant backups are incredibly important when deploying new changes, so you can use them to quickly roll back changes.

Once you've created a tenant, you can click the icon to access tenant settings.

Select the appropriate tags and click Apply. Remember, you can also deploy to a single tenant by clicking the icon on that specific tenant.

Set up a new release by clicking at the top of the page.

In the Releases panel, click

When you're ready, click at the bottom of the panel.

Click at the top of the page to deploy a release to your selected tenants.

This would include developing on a development tenant, pushing final changes to a stage tenant where all of your happens, and then deploying releases from stage.

Read more about the entire Development Lifecycle .

QA and testing
here
Enabling the RBAC Override option
An example of available permissions with RBAC Override enabled