Sanity logosanity.ioAll Systems Operational© Sanity 2026
Change Site Theme
Sanity logo

Documentation

    • Overview
    • Platform introduction
    • Next.js quickstart
    • Nuxt.js quickstart
    • Astro quickstart
    • React Router quickstart
    • Studio quickstart
    • Build with AI
    • Content Lake
    • Functions
    • APIs and SDKs
    • Visual Editing
    • Blueprints
    • Platform management
    • Dashboard
    • Studio
    • Canvas
    • Media Library
    • App SDK
    • Content Agent
    • HTTP API
    • CLI
    • Libraries
    • Specifications
    • Changelog
    • User guides
    • Developer guides
    • Courses and certifications
    • Join the community
    • Templates
Developer guides
Overview

  • Develop with AI

    Best practices

  • Query optimization

    Paginating with GROQ
    High performance GROQ

  • Roles and authentication

    Setting up Single Sign-On with SAML
    Third-Party Login (Deprecated)
    OAuth2
    Set up SSO authentication with SAML and Azure/Entra ID
    Set up SSO authentication with SAML and PingIdentity
    Set up SSO authentication with SAML and JumpCloud
    Reconcile users against internal systems
    Restrict Access to Specific Documents
    Setting up a Default Relay State for IdP Initiated - SAML Logins

  • Structured content

    Scalable navigation patterns
    An opinionated guide to Sanity Studio
    Browsing Content How You Want with Structure Builder
    Deciding on fields and relationships
    Create richer array item previews
    Dynamic folder structure using the currentUser and workflow states
    Create a time duration object field
    Level up Your Edit Modal with Next/Previous Navigation Buttons for Array Items
    Create a “coupon generator” string field input
    Managing redirects with Sanity
    Create a document form progress component
    Create an array input field with selectable templates
    Creating a Parent/Child Taxonomy
    Create interactive array items for featured elements
    Create a visual string selector field input
    Create a survey rating number field input
    How to use structured content for page building
    Create a recycling bin for deleted documents via Sanity Functions

  • Frontend integration

    Add live content to your application
    Forms with Sanity
    Vercel Integration
    Build your blog with Astro and Sanity
    How to implement front-end search with Sanity

  • Ecommerce

    Displaying Sanity content in Shopify
    Sanity Connect for Shopify
    Custom sync handlers for Sanity Connect

  • Integrating with other services

    A/B testing with Sanity and Growthbook
    Cookie consent integrations with Sanity
    Integrating external data sources with Sanity
    Klaviyo (email campaigns)
    Developing with Next.js on GitHub Codespaces

  • Adopting Sanity

    How to pitch Sanity.io to your team
    Convincing your clients to go with Sanity.io, rather than a traditional CMS
    Not-profit plan
    Agencies: Navigating the Spring 2025 Organization Changes
    How to generate massive amounts of demo content for Sanity
    How to implement Multi-tenancy with Sanity

  • GROQ

    GROQ-Powered Webhooks – Intro to Filters
    GROQ-Powered Webhooks – Intro to Projections

  • Portable Text

    Presenting Portable Text
    Add Inline blocks for the Portable Text Editor
    Beginners guide to Portable Text
    How to add custom YouTube blocks to Portable Text
    Converting Inline Styles to Sanity Block Decorators
    Add things to Portable Text
    Change the height of the PTE

  • Community and ecosystem

    Create your own Sanity template
    Community guides
    Community Code of Conduct
    Contribute to the ecosystem

  • Plugin development

    Migrating plugins to support Content Releases

On this page

Previous

Convincing your clients to go with Sanity.io, rather than a traditional CMS

Next

How to generate massive amounts of demo content for Sanity

Was this page helpful?

On this page

  • Moving to an organization-centric model
  • How to make the switch
  • Project Transfer Process
  • Billing Considerations
  • Best Practices for Agencies
  • Summary: Benefits for Clients
  • Next Steps
Developer guidesLast updated September 24, 2025

Agencies: Navigating the Spring 2025 Organization Changes

How to handle the changes to Organizations and Projects in Sanity

This developer guide was contributed by Tom Smith (Principal Solutions Architect at Sanity).

With the recent Spring 2025 release, Sanity has introduced several new powerful features, some of which are on the organization level. This change makes it essential for agencies to consider how they structure their client projects within Sanity.

These new features include:

  • Media Library for centralized asset management
  • Sanity Canvas for AI-assisted content creation
  • Functions for serverless automation
  • Agent Actions for schema-aware AI workflows
  • A centralized organization Dashboard and Insights for unified content operations

As part of our Content Operating System launch, Sanity has started a shift from being project-centric to organization-centric. Features like Media Library, Functions (compute resources), and Content Releases are now shared and managed at the organization level, with pricing structured accordingly. This change makes it essential for agencies to consider how they structure their client projects within Sanity.

Moving to an organization-centric model

Historically some agencies have created a single organization owned by the agency with many projects for each client. This approach was typically done to centralize project management and oversight. However, with Sanity's organization-centric features, agencies who maintain a single organization for all their clients will be sharing these resources and their associated costs across all projects. This can lead to inefficient resource allocation, mix ups and billing challenges when trying to determine which client should be charged for what usage.

By creating separate organizations for each client, you can:

  • Clearly separate billing and resource usage by client
  • Provide clients with their own Media Library for asset management
  • Enable clients to manage their own user permissions and access controls (enterprise projects)
  • Allow for more accurate tracking of compute and API usage per client
  • Simplify the eventual handoff process when projects are completed

How to make the switch

Project Transfer Process

If you're an agency looking to move client projects to their own organizations, here's how to do it. You can also see this in our documentation.

  • Create a new organization for the client
    • You can either create this organization yourself (and be an admin on it initially)
    • Or ask your client to create their own organization and prepare to receive the transfer
  • Initiate the project transfer
    • Log into Sanity Manage
    • Select the project you want to transfer
    • Navigate to the project settings
    • Find the transfer option and select the receiving organization
  • Complete the transfer
    • If you have billing rights in both organizations, the transfer happens instantly
    • Otherwise, a billing manager in the receiving organization must approve the transfer
    • Once approved, billing is automatically prorated between organizations

Billing Considerations

When transferring projects between organizations:

  • The sender is refunded the already paid amount for the remainder of the month
  • The receiver is charged for the remainder of the month at the time of transfer
  • The receiving organization becomes responsible for any overage charges accrued on the project
  • The transfer does not change the project plan or resource quotas

Best Practices for Agencies

  • Plan your organization structure in advance
    • Always create client-specific organizations from the start for new projects
    • For existing clients, discuss the transfer process and benefits before making changes
  • Document ownership and access
    • Clearly define who will have admin access to the client organization
    • Determine if the agency needs ongoing admin access or if it will be fully transferred
  • Communicate pricing implications
    • Explain to clients how organization-level features like Media Library and Functions are billed
    • Help clients understand the benefits of having their own dedicated resources
  • Consider timing
    • Schedule transfers at the beginning of billing cycles when possible to minimize proration complexity
    • Plan transfers during lower-activity periods to minimize disruption

Summary: Benefits for Clients

Moving clients to their own organizations provides several advantages:

  • Resource isolation: Client assets and compute resources are completely separate from other clients
  • Simplified billing: Clients receive clear, dedicated billing for their Sanity usage
  • Better security: Access controls are isolated to just the client's content
  • Ownership clarity: Clients have full control over their content infrastructure, and future changes in agencies won't impact them negatively (although of course, hopefully that doesn't happen!)
  • Easier scaling: Organization-level features can be scaled according to each client's specific needs

Next Steps

Moving from a single agency-owned organization to client-specific organizations aligns with Sanity's evolution into a complete Content Operating System. This structural change not only provides clearer resource allocation and billing but also enables both agencies and clients to take full advantage of Sanity's new organization-centric features. For agencies managing multiple client projects, we recommend:

  • Audit your current organization structure - Identify which client projects should be moved to their own organizations
  • Create a migration timeline - Prioritize transfers based on client needs and feature usage
  • Update your onboarding process - Adjust how you set up new client projects to start with dedicated organizations
  • Communicate the benefits - Help clients understand why this change improves their experience with Sanity By embracing this organization-centric approach, agencies can provide better service to their clients while taking full advantage of Sanity's powerful new features like Media Library, Canvas, and Functions—all while maintaining clear boundaries between client resources and billing.

If you have questions about this transition or need assistance with project transfers, please reach out to our support team or join our community Discord for guidance.