# Logo
## General rules
- Keep it legible and give it space
- Use only approved versions of the logo
- Don't alter the logo's colors, proportions, or orientation
- Don't add effects, textures, or patterns
## Lockups & variants
The logo can appear as a _logomark_ or combination mark _lockup_. The logomark is a standalone icon that can be used in contexts where the full logo may not fit, or when a more minimal representation is called for. The combination mark lockup includes both the logomark and the _wordmark_. Never use the wordmark without the logomark.
Pulumi Logo Lockups Color
The logo has two type lockups: horizontal and stacked. The horizontal lockup is the primary version and should be used whenever possible. The stacked lockup may be used when a more vertical orientation is necessary or when a more compact logo is needed.
Pulumi Logo Lockups Monochrome
Monochrome versions of the mark and each lockup are available for use when the color logo doesn't provide sufficient contrast or when a single-color logo is preferred for aesthetic reasons.
Pulumi Logo Icons
Icons with backgrounds included are also provided for easily updating profile pictures and app icons.
## Sizing & reproduction
Pulumi Logo Placement and Sizing
- Give the logo adequate breathing room by maintaining a clear space around it. The minimum clear space should be equal to half the logo's height (if the logo height is `N`, clear space is `N/2`). This space should be free of any other graphic elements, text, or images.
- The horizontal logo should never be reproduced smaller than 0.25 inches (6.35 mm) in height for print or 16 pixels in height for digital use to ensure legibility. The stacked logo should never be reproduced smaller than 0.75 inches (19 mm) in height for print or 50 pixels in height for digital use.
- Don't reproduce the logo at low resolution or allow it to appear pixelated or blurry.
## Background & contrast
- Only place the color logo on white, black, service black, brand grays, or the following brand violet colors: Light: `Violet 50`, `Violet 100`, Dark: `Violet 900`, `Violet 950`
- For glass or transparent signage, default to the white monochrome logo unless the black monochrome logo provides better contrast in the specific location.
- Don't place the logo on busy or cluttered backgrounds
- Don't place the logo on backgrounds that create insufficient contrast
## Composition & placement
- Don't use the logo as a repeating pattern or texture
- Don't crop, clip, or partially hide the logo
- Don't place the logo inside a shape or container (badge, circle, box) other than the provided icon variants
- Don't stack or overlap other logos directly on top of the logo
## Effects & styling
- Don't apply drop shadows, gradients, glows, or outlines
- Don't apply opacity or transparency effects
- Don't apply filters or blend modes to the color versions of the logo
## File usage
- Always use original source files; never recreate or redraw the logo
- Always use vector versions of the logo when possible
- Don't screenshot or export the logo from a PDF/presentation for reuse
## Get the logo
There are four ways to get an approved logo: download the full asset package, build a single variant interactively, ask an AI assistant for one, or generate one on demand from the logo API.
### Download the asset package
The brand-assets package contains all standard logos, colors, font files, and supporting imagery:
Download
### Build a logo
Pick a lockup, background, size, and format to preview an approved logo variant, then download the file or copy its permanent URL.
### Ask your agent
Working in an AI assistant? Point it at the logo service and describe what you need in plain English — it builds the right link and returns the image or a download URL.
- **Any assistant** — paste `https://brand.pulumi.com/api` into the chat; it reads the self-describing schema, then fetches the logo you describe.
- **MCP clients** (Claude, Cursor, and friends) — connect once to `https://brand.pulumi.com/mcp` for a dedicated `get_logo` tool, plus the rest of the brand guidelines. See the [Brand MCP server](/mcp-server/) page for setup.
> _"Use brand.pulumi.com/api to get a full-color Pulumi logo, 1024×1024 PNG, under 1 MB."_
### Render from the API
In addition to the logo files included in the brand-assets package, there's also a self-describing API endpoint that dynamically renders approved logo variants on request:
```bash
curl https://brand.pulumi.com/api
```
```bash
curl https://brand.pulumi.com/api/logo?format=svg&width=600
```
API responses return valid image variants as bytes, along with `Content-Location` and `Link` headers that denote the generated image's permanent URL:
```bash
curl -sI "https://brand.pulumi.com/api/logo?lockup=horizontal&background=violet-950&width=400&height=160&format=png"
```
```http
HTTP/2 200
content-type: image/png
content-location: /media/images/logos/horizontal-violet-950-400x160.png
link: ; rel="canonical"
```
These URLs (at `/media`) are the _canonical_ ones. You should use these — and _not_ raw `/api` URLs — in `![]()
` tags, for example, as they're stable, cached, self-describing, and have no query strings.
```html
```
#### Parameters
| Name | Values | Default |
| ------------------- | --------------------------------------------------------------------------------- | ----------------------- |
| `lockup` | `horizontal` `stacked` `mark` `icon-circle` `icon-rounded` `icon-square` `auto` | `auto` |
| `treatment` | `color` `monotone` | `color` |
| `theme` | `light` `dark` | `light`, `dark` when a dark `background` is specified |
| `background` | `transparent` `white` `black` `service-black` `violet-50` `violet-950` | `transparent` |
| `width`, `height` | Integers up to 4096 | Source width/height |
| `units` | `px` `cm` `in` | `px` |
| `dpi` | Integers up to 600 | `300` |
| `format` | `svg` `png` `jpg` `pdf` | `svg` |
| `usage` | `web` `print` `social-avatar` `slide-deck` `favicon` `email-signature` | — |
Raster formats (`png` / `jpg`) need at least one dimension; `svg` and `pdf` scale on their own. If you omit `theme`, the service picks the variant that stays legible on your `background` (dark backgrounds get the dark artwork). Set this explicitly when a `transparent` logo will sit on a dark surface.
##### Presets
Several presets are available (in all supported formats) for convenience:
| Preset | Example |
| ----------------- | ------- |
| `web` | `https://brand.pulumi.com/media/images/logos/web.svg` |
| `print` | `https://brand.pulumi.com/media/images/logos/print.pdf` |
| `social-avatar` | `https://brand.pulumi.com/media/images/logos/social-avatar.jpg` |
| `slide-deck` | `https://brand.pulumi.com/media/images/logos/slide-deck.pdf` |
| `favicon` | `https://brand.pulumi.com/media/images/logos/favicon.png` |
| `email-signature` | `https://brand.pulumi.com/media/images/logos/email-signature.png` |
| `custom` | `https://brand.pulumi.com/media/images/logos/custom.svg` |
##### Common examples
###### Web wordmark (SVG)
```bash
curl -I https://brand.pulumi.com/api/logo?usage=web
```
###### Social avatar
```bash
curl -I https://brand.pulumi.com/api/logo?usage=social-avatar
```
###### Favicon
```bash
curl -I https://brand.pulumi.com/api/logo?usage=favicon
```
###### Horizontal on violet, 2000×800 PNG
```bash
curl -I /api/logo?lockup=horizontal&background=violet-950&width=2000&height=800&format=png
```
###### Horizontal on white, 1200×480 PNG
```bash
curl -I /api/logo?lockup=horizontal&background=white&width=1200&height=480&format=png
```
###### Monotone dark mark, PDF
```bash
curl -I /api/logo?lockup=mark&treatment=monotone&theme=dark&format=pdf
```
## Trademark usage
For questions about trademark usage, licensing, and third-party use of the Pulumi name and logo, see the [Pulumi Trademark Usage Policy](https://www.pulumi.com/trademark/).