Skip to main content
Brand libraries store your brand identity — name, website, tagline, and description. When you generate content with a brand library attached, Pixa uses that identity to produce on-brand results.

​
CLI commands

SubcommandDescription
brands listList all brand libraries with identity details
brands get <id>Get a brand library’s details
brands createCreate a new library (--name required, --website, --tagline, --description optional)
brands delete <id>Delete a brand library

​
Managing libraries

​
List all libraries

pixa brands list --json

​
Create a library

pixa brands create --name "Acme Brand" --json

{
  "ok": true,
  "data": {
    "id": "lib_brand456",
    "name": "Acme Brand"
  }
}

​
Create with full identity

pixa brands create \
  --name "Acme Brand" \
  --website "https://acme.com" \
  --tagline "Quality you can trust" \
  --description "Premium outdoor gear for adventure seekers" \
  --json

​
Get library details

pixa brands get lib_brand456 --json

​
Delete a library

pixa brands delete lib_brand456 --json

​
Using a brand library with generation

Pass the --brand-library flag to apply brand identity to any generation task: 
pixa run prompt "social media banner for summer sale" \
  --brand-library lib_brand456 \
  --aspect-ratio 16:9 --json
This ensures that generated images follow the brand’s visual guidelines — consistent colors, typography, and style.

​
Via JSON input

pixa run prompt --json-input '{
  "message": "product announcement graphic",
  "generation_settings": {
    "brand_library_id": "lib_brand456",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}' --json

​
End-to-end workflow

# 1. Create the brand library
pixa brands create --name "Acme Brand" --json

# 2. Generate brand-consistent content
pixa run prompt "Instagram post announcing new product line" \
  --brand-library lib_brand456 \
  --aspect-ratio 1:1 \
  --num-variations 3 --json

# 3. Generate another piece with the same brand
pixa run prompt "email header for product launch" \
  --brand-library lib_brand456 \
  --aspect-ratio 3:1 --json

# 4. Verify the library is available
pixa brands get lib_brand456 --json
Generate multiple variations with --num-variations to pick the best result while maintaining brand consistency across all options.
For more on brand libraries and how to configure brand identities in the web app, see the Brand Libraries guide.