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
  • Custom Domain
  • Connect via Xano Domain
  • Database Connector
  • Upgrading an Instance
  • Does upgrading happen automatically once I pay?
  • How to upgrade an instance
  • Step 1 - Go to the Billing page
  • Step 2 - Select a plan
  • If your base API URL is changing...
  • Step 4 - Update your Front-end with the new API URL ORIGIN if you are upgrading from the FREE plan or changing your server region.
  • Step 5 - Complete your upgrade

Was this helpful?

  1. Xano Features

Instance Settings

Last updated 4 months ago

Was this helpful?

Custom Domain

Xano has support for users on the Launch, Scale and Enterprise plans to set up a custom domain to be used on the URLs of their API endpoints.

How to set up your custom domain in Xano:

  1. Navigate to your Instances page.

  2. Open the menu on your instance and select Custom Domain, a panel on the right will open like below.

  3. Carefully read and follow the instructions to update your DNS records: Create a CNAME record to the address provided, set the TTL to 5 minutes, and depending on your provider allow time for your DNS to propagate properly.

  4. Enter your custom domain name at the bottom and click submit.

Once completed, you can use your custom domain on your API endpoints.

Connect via Xano Domain

In some cases, you may still want to connect to your Xano instance via the original Xano domain. To connect through your Xano domain, head to your instance selection screen. Click the three dots when hovering over your instance, and choose "Connect Via Xano Domain".

Database Connector

Database Connector is a premium add-on that is available for Launch and Scale plans. Please visit your Billing page for the most up-to-date pricing for this additional feature.

You have the option to connect your Xano instance's PostgreSQL database directly with an external application or service. This can be useful if there is a platform for manipulating your database that you prefer to use over the Xano interface, creating custom backup and restore solutions, or even performing data analytics.

Use care when accessing your database directly. This type of connection removes a significant portion of normal checks and balances for data validity that using Xano directly provides.

Proceed with caution.

How to Access the Database Connector

On your instance selection screen, click the ⚙️ icon, and in the panel that opens, choose Database Connector.

The panel that opens is split into two sections, Details and Settings.

Details allows you to retrieve the access information for a direct database connection.

Settings allows you to enable and use an allow list, to limit direct database connections to specific IP addresses.

  1. Get your database's public IP

  2. Get your database credentials

  3. Settings Panel

  4. Add an IP address to your allow list

Clicking both of the "Get" buttons will provide us with the database IP and two sets of credentials, full-access and read-only.

From this panel, you can also revoke and re-generate your database credentials, should the need arise.

Establishing a Database Connection (Example)

You can use any application you'd like that is capable of connecting to a PostgreSQL database. In this example, we'll be using Navicat.

Select 'Connection' in the top-left, and fill in your credentials and the IP recieved from Xano.

Click 'Save' to save the connection. We can now navigate the PostgreSQL database from Xano using Navicat. We can even add / update data, run queries, etc...

Upgrading an Instance

What can I upgrade to? If you are on our Launch plan, your next step would be Scale1x. Upgrades from Launch to Scale1x are able to make use of a 48 hour no questions asked refund policy -- if you find that Scale1x is not solving the requirement that prompted the upgrade, reach out to support within 48 hours and we'll roll you back to Launch and refund the difference.

If you are currently on a Scale plan and considering a higher tier, we can work with you to trial higher Scale tiers by reaching out to support.

What does upgrading your instance actually do? Upgrading your instance migrates your data and business logic to a brand new, faster instance. If you upgrade to the Scale package, you'll be put on your own dedicated instance for maximum performance and scalability.

How long does upgrading take? Upgrading an instance takes seconds to complete.

Does upgrading happen automatically once I pay?

You will need to update your API URL ORIGIN if:

  • You are adding certain features to your plan, such as Static IP

  • You are upgrading from free to paid

  • You are changing your server region

You do not need to update your API URL ORIGIN if: - You are upgrading from a PAID to PAID instance and not changing your server location.

How to upgrade an instance

Step 1 - Go to the Billing page

Go to the Billing section within Xano. You can get there by clicking "Billing" in the side menu on the instances page. You can also click your initials when you're in your workspace and clicking the "Billing" link.

Step 2 - Select a plan

Click the Change Plan button on the instance you want to upgrade.

On the next screen, you'll be able to change your current plan, modify your billing schedule, add additional upgrades, or change your region.

Once you've made your selections, click the green button at the bottom to proceed to checkout.

If your base API URL is changing...

THIS IS THE MOST IMPORTANT STEP

To ensure a seamless transition for your users, please read this section carefully.

Click the "Start Upgrade" button...

Don't worry, this doesn't start the upgrade right away. This will bring up a dialog telling you what you need to be aware of before continuing.

Write down your new API URL Origin

What is an API URL ORIGIN anyway? It's the first part of any API endpoint you have hooked up to the front-end. See below for an example

YOUR API URL ORIGIN (example)
https://xd6b-cfde-62f6.dev.xano.io/

YOUR FULL API ENDPOINT URL FOR 'GET USERS' (example)
https://xd6b-cfde-62f6.dev.xano.io/api:4qSkfrOl/user

Step 4 - Update your Front-end with the new API URL ORIGIN if you are upgrading from the FREE plan or changing your server region.

Step 5 - Complete your upgrade

Once you follow the steps above, type I UNDERSTAND into the box and click the button "Start upgrade now".

Why should you upgrade? Free accounts come with one workspace that shares resources with other Xano customers. It also is limited on capabilities such as storage, database records, and processing power. You'll easily be able to prototype most of your application in this type of account, but upgrading to a paid plan will give you a more powerful instance that can scale with your needs. .

View plan pricing and details
To use your custom domain, navigate to your Instances page and follow the given instructions.