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
  • The Anatomy of the Visual Builder
  • What can I build?
  • APIs
  • Custom Functions
  • Background Tasks
  • Triggers
  • Middleware
  • Using the Visual Builder
  • Adding Functions
  • Creating a Draft
  • Revertible Changes
  • Compare Differences
  • Testing a Draft
  • Publishing
  • Working with Data
  • Filters
  • Dot Notation
  • Auto-Complete / Subpath
  • Copy and Paste
  • Selecting Functions
  • Keyboard Navigation

Was this helpful?

  1. The Function Stack

Building with Visual Development

Last updated 1 month ago

Was this helpful?

The Anatomy of the Visual Builder

The builder will be comprised of up to three different sections — inputs, the function stack, and the response. Different function stack types may not contain all of the available sections listed below.


What can I build?

APIs

An API is a piece of logic or a workflow that can be called to run from external sources. Think about when you tap a button or link anywhere in an application; there are API calls happening behind the scenes to make sure those taps perform the expected action.

Custom Functions

A custom function is similar to an API, but it is reusable logic that you can insert into any other function stack. These are useful if you are implementing similar logic in multiple places, and allows you to build and maintain that logic in a single location.

Background Tasks

A background task is a workflow that runs automatically based on a schedule that you define.

Triggers

A trigger is a workflow that runs every time something else happens. Xano supports two different kinds of triggers: database triggers and realtime triggers. Database triggers run every time a certain change is made in a database table, and realtime triggers run based on events in a realtime channel.

Middleware

Think of middleware as an extra security guard at the entrance and exit of your other function stacks. You can build and deploy middleware to run either before a function stack, or right before it delivers a response. This is useful for things like input or output sanitization, custom error logging, security, and more.


Using the Visual Builder

You can use both mouse and keyboard navigation when working in the builder.

Adding Functions

You can also hover over an existing function and click the + sign to add a new function directly under it.

Not sure where to start?

Creating a Draft

Revertible Changes

Revertible changes show each micro-change, when they were made, what the change was, and who made it.

To revert a change, select the change you wish to revert back to. You can also revert all changes to revert all changes in the draft and return to the original version of the Function Stack.

Compare Differences

Before reverting a change, you are able to see a difference comparison snapshot of the previous draft version. This provides context in the differences of the previous version compared to the current draft you are on.

Comparing versions in function stacks using Lambda Functions or Template Engine will show your specific code changes in a specialized format for easy readability.

Once you're ready to revert, select Restore this version.

Testing a Draft

Testing the API with Run & Debug will use the draft you are editing while calling the API from the front-end will use the live (published version) of the API.

If you have other drafts across your workspace that may interact with the current API or Function Stack you are editing, you can include the relevant drafts while testing in Run & Debug.

Publishing

Once you're ready to publish the changes, you can simply select publish.

You can include a description of the changes you are publishing. Additionally, you have the option to publish other active drafts in your workspace. This might be useful if you are working with multiple workspace objects that interact or depend on one another and need to be certain everything works harmoniously before publishing.

Once a draft is published, the changes will become live. Meaning if the API endpoint is called from a front-end, the changes will be reflected. Publishing a draft will create a new version of the API Endpoint, which allows you to roll back to previously published versions.

How do I know if I have drafts to publish?

You can see drafts available for testing and publish via the Publish dialog on any of your function stacks, or in a notification on the dashboard. If you find that you have made changes but are not seeing the expected results via your front-end, ensure that you have published these changes.


Working with Data

Filters

Filters are additional functions that can be applied directly to other pieces of data in Xano. For example, a filter could be used for a mathematical operation, adjust text formatting, create new datasets from existing data, and more.

To apply a filter, just hover over a value box and click Add Filter.

Dot Notation

Dot Notation is used to navigate inside of variables and target specific pieces of data.

Let's use the following object as an example. This object is contained in a variable called author.

{
    id: 2,
    created_at: 1736364473744,
    name: "john Smith",
    genre: "Western"
}

Notice how the name field is not capitalized properly. When we edit this variable, we can use dot notation to target that name field specifically, like this:

author.name

This will tell Xano to keep the rest of the object the same, and only update the name field with whatever our adjustments are.

Auto-Complete / Subpath

Xano keeps an understanding of the contents inside of your variables, which makes targeting data inside them easy.

In this example, we have a customer variable that contains data from our database. If you want to target a specific piece of information inside of that variable, such as the customer's email or name, you can click "x properties" next to the variable name.

Once you do that, you'll be able to select the data you're looking for.


Copy and Paste

You can copy and paste function stacks in Xano, enabling speedy development across environments.

Copy and paste works inside of your own function stacks, as well as copying and pasting between workspaces and instances.

Hint

Selecting Functions

You can hold Shift and click on individual functions to select them.

Alternatively, you can also hold Shift and click + drag to select multiple functions.

When you're ready to paste, you can do so with the same standard keyboard shortcut: Crtl+V / Cmd+V.


Keyboard Navigation

Section
Key
Action

Function Stack

↑ ↓

Navigate Function Stack rows inputs and response values

Function Stack

Shift ↑ ↓

Select multiple rows

Function Stack

A

Add row below highlighted row or inside highlighted empty row

Function Stack

Delete

Delete highlighted row or selection of rows

Function Stack

Enter

Edit the highlighted row

Function Stack

D

Edit the description of highlighted row

Function Stack

Cmd/Ctrl C

Copy the highlighted row or selection

Function Stack

Cmd/Ctrl X

Cut the highlighted row or selection

Function Stack

Cmd/Ctrl V

Paste function stack clipboard contents below currently highlighted row

Function Stack

Cmd/Ctrl Z

Undo last change

Function Stack

Cmd/Ctrl /

Disable/enable highlighted row

Function Stack

F

Convert a selection of rows into a function

Function Stack

G

Group a selection of rows

Function Stack

C

Clone highlighted row

Function Stack

Option/Alt ↑ ↓

Move highlighted row

Inputs and Response

Enter

Edit highlighted input/response

Inputs and Response

Delete

Delete highlighted input/response

Inputs and Response

C

Clone highlighted response

Page Actions

Cmd/Ctrl Z

Undo last action

Page Actions

Cmd/Ctrl Enter

Open the Run & Debug panel

Page Actions

Cmd/Ctrl P

Open the Publish panel`;

📖

📖

📖

📖

📖

Click to add functions to your function stack. You can search for, choose, and favorite functions in the panel that appears on the right.

Xano can for you based on your tables.

Once you start editing your API, a draft will automatically be created. Drafts keep track of each micro-change you (or your ) make to a Function Stack called Revertible Changes, which you can easily roll back.

To learn more about the available filters in Xano, head to the Filters section .

If you need to reuse logic in more than one place, it is recommended to utilize

Click your desired option or use keyboard shortcuts for your operating system of choice. Crtl+C / Crtl+X on Windows, or Cmd+C / Cmd+X on Mac.

🛠️
team members
here
Custom Functions.
Learn more about APIs
Learn more about custom functions
Learn more about background tasks
Learn more about triggers
Learn more about middleware
auto-generate basic endpoints

🔄 Function stack

This is where all of the magic happens. All of the business logic that is performed lives here.

As you add functions to your function stack, it will suggest next steps based on most popular user activity.

⬆️ Response

Once the function stack has done its job, it needs to know what to return. This lives in the Response section.

⬇️ Inputs

The inputs are anything that a function stack needs to run. For example, a function stack that logs in a user probably needs a username or email and a password; these would be the inputs.

Note

We're currently rolling out this feature to all users as part of our next release. If you don't have it yet, you will soon! Hang tight.

Comparing differences of a previous version to the current draft.
Optionally include relevant drafts during Run & Debug.
Optionally include a description of the published changes. Also, you may publish other drafts in the workspace at the same time.