Custom tags available in beta on Vercel Sandbox

Custom tags available in beta on Vercel Sandbox - Vercel

Skip to content

[](http://vercel.com/home)

• Products

• ##### AI Cloud

• AI Gateway One endpoint, all your models
• Sandbox Isolated, safe code execution
• Vercel Agent An agent that knows your stack
• AI SDK The AI Toolkit for TypeScript
• v0 Build applications with AI

• ##### Core Platform

• CI/CD Helping teams ship 6× faster
• Content Delivery Fast, scalable, and reliable
• Fluid Compute Servers, in serverless form
• Workflow Long-running workflows at scale
• Observability Trace every step

• ##### Security

• Bot Management Scalable bot protection
• BotID Invisible CAPTCHA
• Platform Security DDoS Protection, Firewall
• Web Application Firewall Granular, custom protection

• Resources

• ##### Company

• Customers Trusted by the best teams
• Blog The latest posts and changes
• Changelog See what shipped
• Press Read the latest news
• Events Join us at an event

• ##### Learn

• Docs Vercel documentation
• Academy Linear courses to level up
• Knowledge Base Find help quickly
• Community Join the conversation

• ##### Open Source

• Next.js The native Next.js platform
• Nuxt The progressive web framework
• Svelte The web’s efficient UI framework
• Turborepo Speed with Enterprise scale

• Solutions

• ##### Use Cases

• AI Apps Deploy at the speed of AI
• Composable Commerce Power storefronts that convert
• Marketing Sites Launch campaigns fast
• Multi-tenant Platforms Scale apps with one codebase
• Web Apps Ship features, not infrastructure

• ##### Tools

• Marketplace Extend and automate workflows
• Templates Jumpstart app development
• Partner Finder Get help from solution partners

• ##### Users

• Platform Engineers Automate away repetition
• Design Engineers Deploy for every idea

• Enterprise
• Pricing

Ask AI

Ask AILog In

Sign UpSign Up

Blog/Changelog

Custom tags available in beta on Vercel Sandbox


1 min read

Copy URL

Copied to clipboard!

Apr 29, 2026

As teams scale isolated environments for AI agents, code generation, or dev workflows, keeping track of which sandbox belongs to whom, and why, becomes critical. Custom tags allow you to organize, filter, and manage Vercel Sandboxes at scale. Each sandbox supports up to five tags.

[Link to heading](http://vercel.com/changelog/custom-tags-available-in-beta-on-vercel-sandbox#organize-by-environment,-team,-or-customer)Organize by environment, team, or customer

Tags are flexible by design. Use them to separate staging from production, attribute usage to specific teams, or isolate sandboxes per customer in multi-tenant platforms:

`1const sandbox = await Sandbox.create({2 name: "my-sandbox",3 tags: { env: "staging" },4});`

[Link to heading](http://vercel.com/changelog/custom-tags-available-in-beta-on-vercel-sandbox#update-tags-as-context-changes)Update tags as context changes

Promote a sandbox from staging to production, reassign ownership, or mark it for cleanup without recreating it:

`1await sandbox.update({2 tags: { env: "production", team: "infra" },3});`

[Link to heading](http://vercel.com/changelog/custom-tags-available-in-beta-on-vercel-sandbox#easily-track-your-sandboxes)Easily track your sandboxes

Filter sandboxes by any tag to quickly surface the ones that matter. This is useful for dashboards, cleanup scripts, or routing logic that needs to find all sandboxes matching a specific environment or team:

`1const productionSandboxes = await Sandbox.list({2 tags: { env: "production" },3});4console.log(5 "Production sandboxes:",6 productionSandboxes.sandboxes.map((s) => s.name),7); // my-sandbox`

[Link to heading](http://vercel.com/changelog/custom-tags-available-in-beta-on-vercel-sandbox#use-cases)Use Cases

• **AI agents at scale**: Tag sandboxes by session, user, or agent run to track which execution environment belongs to which workflow.

• **Multi-tenant platforms**: Isolate and filter sandboxes per customer or workspace, making billing attribution and cleanup straightforward.

• **Team-level visibility**: Attribute sandbox usage to specific teams for cost tracking or capacity planning.

This feature is in beta and requires upgrading to the beta SDK and CLI packages. Learn more in the documentation.

**Ready to deploy?**Start building with a free account. Speak to an expert for your _Pro_ or Enterprise needs.

Start DeployingTalk to an Expert

**Explore Vercel Enterprise** with an interactive product tour, trial, or a personalized demo.

Explore Enterprise

Get Started

• Templates
• Supported frameworks
• Marketplace
• Domains

Build

• Next.js on Vercel
• Turborepo
• v0

Scale

• Content delivery network
• Fluid compute
• CI/CD
• Observability
• AI Gateway New
• Vercel Agent New

Secure

• Platform security
• Web Application Firewall
• Bot management
• BotID
• Sandbox New

Resources

• Pricing
• Customers
• Enterprise
• Articles
• Startups
• Solution partners

Learn

• Docs
• Blog
• Changelog
• Knowledge Base
• Academy
• Community

Frameworks

• Next.js
• Nuxt
• Svelte
• Nitro
• Turbo

SDKs

• AI SDK
• Workflow SDK New
• Flags SDK
• Chat SDK
• Streamdown AI New

Use Cases

• Composable commerce
• Multi-tenant platforms
• Web apps
• Marketing sites
• Platform engineers
• Design engineers

Company

• About
• Careers
• Help
• Press
• Legal
• Privacy Policy

Community

• Open source program
• Events
• Shipped on Vercel
• GitHub
• LinkedIn
• X
• YouTube

[](http://vercel.com/home)

Loading status…Select a display theme:system light dark