Skip to main content
Review dashboard concepts first. See Multisite Overview.

​
API architecture

Each site and environment in ButterCMS has its own API configuration:

​
API token structure

Site A (Production) → API Token: abc123...
Site A (Staging)    → API Token: def456...
Site A (Dev)        → API Token: ghi789...
Site B (Production) → API Token: jkl012...

​
Making API calls

When fetching content, specify the appropriate API token for your target site/environment: 
// Production site
const butterProd = Butter('your-production-api-token');

// Staging site
const butterStaging = Butter('your-staging-api-token');

// Fetch from specific environment
const prodPages = await butterProd.page.list('landing-page');
const stagingPages = await butterStaging.page.list('landing-page');

​
Draft mode for staging

Use the preview=1 parameter to fetch draft content on staging environments: 
// Staging environment configuration
const response = await butter.page.retrieve('*', 'my-page', {
  preview: 1  // Include draft content
});