# Photography: design playbook

> Real people doing real work, in daylight, cropped on the subject, in one treatment drawn from the brand's colors.

Checked 2026-10-29. Each value says where it came from: published, our reading, or our recipe.

## Pick a treatment

Our reading. IBM's default is natural and ungraded; Spotify's duotone works because its color pairs are bold and high-contrast; GitLab picks photos that feature or complement the brand colors. A duotone's tonal range is the contrast between its two colors, so the pair has to be far apart.

Take the first row that matches the brand.

1. **The brand publishes a photo treatment** → published. The brand's own recipe beats our table.
2. **Warm, light accent: hue 0–70° or 330–360°, luminance 0.4 or more** → warm. A light warm accent duotones into a pale, flat highlight. As a grade it reads as daylight.
3. **Bold pair: ink and accent contrast 7:1 or more** → duotone. Seven to one leaves the photo a full range of tones in two brand colors.
4. **Vivid cool accent: hue 170–260°, saturation 90% or more** → cool. A saturated cool accent fights a warm, ungraded photo. A light cool grade brings the photo toward it.
5. **Anything else** → natural. Nothing in the palette to match, so IBM's default: natural light, no grade.

## Rules

### 1. Show real people doing real things, never a visual pun.

- Value (published): Patagonia: an honest shot, real people doing real things. IBM: avoid clichés that loosely stand for a concept. GitLab: no people obviously acting.
- Check: The photo's subject is the piece's subject. Fail on tags: handshake, pointing-at-screen, globe, lightbulb, puzzle, chess, thumbs-up, headset-smile.
- Sources: https://www.patagonia.com.hk/blogs/stories/an-honest-shot, https://www.ibm.com/design/language/photography/tips-and-techniques, https://design.gitlab.com/brand-design/photography

### 2. Cast people with intent, and cast widely.

- Value (published): GitLab: people of varied backgrounds, ages, body types, races and genders. Starbucks: people sparingly, thoughtfully, with intention. IBM: equal skill and standards for every subject.
- Check: Across a piece, people photos vary in age and background; no photo of a person is decoration with no role in the copy.
- Sources: https://design.gitlab.com/brand-design/photography, https://creative.starbucks.com/photography/, https://www.ibm.com/design/language/photography/overview

### 3. Shoot at eye level, with a level horizon.

- Value (published): Airbnb: shoot straight ahead, without tilting the lens up or down. IBM: eye level, or aerial; nothing in between, no forced perspective.
- Check: Horizon and verticals within 1° of level; no CSS rotate on a photo.
- Sources: https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687, https://www.ibm.com/design/language/photography/tips-and-techniques

### 4. Natural light, no flash, no color wash.

- Value (published): Airbnb: soft natural light, flash off, blinds open. IBM: natural light; avoid overly warm golden-hour glow, color washes and grading.
- Check: No overlay of one color above 10% opacity across the whole photo; any grade comes from the treatment recipe only.
- Sources: https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687, https://www.ibm.com/design/language/photography/tips-and-techniques

### 5. Keep the subject sharp. Go shallow only for portraits and still life.

- Value (published): IBM: everything in sharp focus; avoid soft focus. GitLab portraits: a shallow depth of field draws attention to the person.
- Check: No CSS blur on a photo. Reportage: no background blur. Portrait or still life: the subject is the sharpest region.
- Sources: https://www.ibm.com/design/language/photography/tips-and-techniques, https://design.gitlab.com/brand-design/photography

### 6. Crop on the subject, not the center.

- Value (published): Set object-position to the photo's focal point. The browser's default is 50% 50%, which crops the subject out of a square or tall frame. IBM: clear focal points, never an empty center.
- Check: Every object-fit: cover photo has object-position equal to its focal point; the focal point lies inside the visible box.
- Sources: https://developer.mozilla.org/en-US/docs/Web/CSS/object-position, https://www.ibm.com/design/language/photography/tips-and-techniques

### 7. Crop to a short list of ratios.

- Value (published): IBM: 16:9, 4:3, 3:2, 2:1 or 1:1. Airbnb: horizontal, because search crops to squares. Mozilla: 1:1 and 9:5 for thumbnails.
- Check: Every photo's rendered width ÷ height is within 1% of 16/9, 2, 3/2, 4/3 or 1; photos in one row share one ratio.
- Sources: https://www.ibm.com/design/language/photography/tips-and-techniques, https://www.airbnb.com/resources/hosting-homes/a/how-to-take-great-photos-for-your-listing-687, https://web.archive.org/web/20250208010059/https://foundation.mozilla.org/en/docs/design/graphics/photography/

### 8. Put text where the photo is quiet, never across a face.

- Value (published): GitLab: place text over the part with the least detail, ideally one color. Mozilla: avoid text over photos where you can.
- Check: Luminance standard deviation under the text box ≤ 0.06 (our measure); the text box overlaps no face or product.
- Sources: https://design.gitlab.com/brand-design/photography, https://web.archive.org/web/20250208010059/https://foundation.mozilla.org/en/docs/design/graphics/photography/

### 9. Text on a photo clears 4.5:1 against its brightest pixels.

- Value (published): WCAG 1.4.3: 4.5:1, or 3:1 for large text, and F83 fails background images without it. Our recipe: test against the brightest 2% of pixels under the text, and if it fails, add a scrim at the opacity that passes.
- Check: contrast(text, the 98th-percentile luminance under the text box, after scrim) ≥ 4.5 (≥ 3 at 24px or 18.66px bold).
- Sources: https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html, https://www.w3.org/WAI/WCAG22/Techniques/failures/F83

### 10. One treatment per piece.

- Value (published): Every photo in a piece gets the same treatment, from the pick table. GitLab: don't pair graphic overlays with text on one image. IBM: no added glare, overlays or effects.
- Check: Every img in the piece carries the same data-treatment; no photo carries both a graphic overlay and text.
- Sources: https://design.gitlab.com/brand-design/photography, https://www.ibm.com/design/language/photography/tips-and-techniques

### 11. Show the whole product on a plain field, with nothing on it.

- Value (published): Apple: product photos only on white, off-white, light gray or black, shown in their entirety, with no type, violators or graphics on them.
- Check: Product photo background is one flat color (luminance std dev ≤ 0.02 at the edges); no element overlaps the product's box.
- Sources: https://apple.com/shop/Catalog/US/Images/affiliates/affiliate-banners-guide.pdf

### 12. Alt text says what the photo shows, for this page.

- Value (published): W3C: informative images get alt text that conveys what they show; decorative ones get alt="". Our reading: one sentence, no "image of" or "photo of", no file names.
- Check: Every img has an alt attribute; non-empty alt doesn't start with image/photo/picture of and doesn't match a file name or extension.
- Sources: https://www.w3.org/WAI/tutorials/images/decision-tree/, https://www.w3.org/WAI/tutorials/images/informative/

### 13. Serve AVIF or WebP at the size it renders; never lazy-load the hero.

- Value (published): web.dev: WebP and AVIF compress better than JPEG and should be used where possible; don't lazy-load images likely in the viewport, and give the LCP image fetchpriority="high". MDN: srcset and sizes let the browser pick the file. GitLab caps any web image at 2MB.
- Check: Every photo is a picture with AVIF and WebP sources, srcset widths and sizes, width and height set; the first in-viewport photo has no loading="lazy" and has fetchpriority="high"; no file over the rendered width × 2.
- Sources: https://web.dev/articles/choose-the-right-image-format, https://web.dev/articles/browser-level-image-lazy-loading, https://web.dev/articles/optimize-lcp, https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images, https://handbook.gitlab.com/handbook/marketing/digital-experience/engineering/image-guidelines/

### 14. Credit every photo, and label any that AI made.

- Value (published): EU AI Act Article 50: AI-generated images that resemble real people, places or events must be disclosed as artificially generated. GitLab: AI-generated images follow the same photo guidelines and go through brand review. Unsplash and Pexels ask for the photographer's credit.
- Check: Every photo carries data-source and data-license; a photo with data-ai="true" shows a visible label; no AI image stands in for a named customer or employee.
- Sources: https://artificialintelligenceact.eu/article/50/, https://handbook.gitlab.com/handbook/marketing/brand-and-product-marketing/design/, https://help.unsplash.com/en/articles/2511245-unsplash-api-guidelines

## What AI gets wrong

- **The globe for "global".** Earth from space for an international product, a lightbulb for ideas, a handshake for partners: the photo repeats the headline and shows nothing real. (rule: real-work)
- **Center crop.** A wide hero crops a portrait at 50% 50% and cuts off the heads. (rule: focal-crop)
- **White text on a busy photo.** A headline in white over foliage or a bright window, with no scrim, under 2:1 in places. (rule: text-contrast)
- **Every photo graded differently.** One duotone, one warm, one black and white, one raw: the page looks assembled from four sites. (rule: one-treatment)
- **A 2,000px JPEG in a 400px card.** The original file, lazy-loaded hero included, with no srcset, sizes or modern format. (rule: weight)
- **AI faces as customers.** A generated portrait over a made-up name and title in a testimonial, with no label. (rule: provenance)

## Treatments

### Natural

- Recipe (published): No filter. Exposure and white balance corrected at source only.
- Params: none
- CSS: `filter: none`
- Sources: https://www.ibm.com/design/language/photography/tips-and-techniques

### Duotone

- Recipe (our recipe): Grayscale by luminance, contrast, then map shadows to {palette.ink} and highlights to {palette.accent}. If the accent is darker than the ink, swap them.
- Params: shadows={palette.ink}, highlights={palette.accent}, contrast=1.15
- CSS: `filter: url(#ph-duotone-{brand})`
- Why: COLLINS describes Spotify's Lens as duotone screen-printing applied to third-party photos; it publishes no numbers. The contrast of 1.15 is ours.
- Sources: https://www.wearecollins.com/work/spotify/, https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feColorMatrix

### Warm grade

- Recipe (our recipe): Shift every pixel toward the brand's warmest color by strength × (tint − its luminance), keeping luminance. Tint = the most saturated brand color with hue 0–70° or 330–360°.
- Params: tint=warmest brand color, strength=0.16
- CSS: `filter: url(#ph-warm-{brand})`
- Why: No system we read publishes grade strengths. Starbucks asks for warm light in the studio. 0.16 was set by eye on the specimen set.
- Sources: https://creative.starbucks.com/photography/

### Cool grade

- Recipe (our recipe): The warm grade with the brand's coolest color: the most saturated with hue 170–260°.
- Params: tint=coolest brand color, strength=0.16
- CSS: `filter: url(#ph-cool-{brand})`
- Why: Same reasoning as the warm grade, toward the cool end of the palette.
- Sources: https://design.gitlab.com/brand-design/photography

### Grain

- Recipe (our recipe): An overlay of fractal noise (baseFrequency 0.9, 2 octaves) in overlay blend at the set amount. Adds to one of the four above, never stands alone.
- Params: amount=0.18
- CSS: `mix-blend-mode: overlay; opacity: {amount}`
- Why: Grain hides banding in duotone gradients. IBM forbids added effects for reportage, so the default is off; set amount only for duotone.
- Sources: https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feTurbulence

### Scrim

- Recipe (our recipe): A gradient of {palette.night} under {palette.on_night} text (or {palette.paper} under {palette.ink}), at the lowest opacity that brings the text to 4.5:1 against the brightest and darkest 2% of pixels under it. A paper scrim must save 10 points of opacity to beat a night one.
- Params: color={palette.night}, opacity=solved per photo, target=4.5
- CSS: `background: linear-gradient(to top, rgb({night} / {opacity}), transparent)`
- Why: WCAG fails text over background images that don't give enough contrast; the 4.5:1 floor is WCAG's. Solving the opacity per photo is ours.
- Sources: https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html, https://www.w3.org/WAI/WCAG22/Techniques/failures/F83

## Sources

### Steal specimen set

- License: CC0 1.0 and public domain, per photo (https://creativecommons.org/publicdomain/zero/1.0/)
- Version: 2026-10-29
- Suits: Drawing rules and treatments; placeholders in drafts.
- Not for: A customer's real work: use their own photos first.
- Knobs: photo id; width 640 or 1280; format avif, webp or jpg; focal point; treatment
- How: Seven photos hosted beside this page, each with its source, author and license in credits.json. Use the focal point for object-position.
- Credits: https://unfairly.ai/steal/design/assets/photography/credits.json
- License files: https://unfairly.ai/steal/design/assets/photography/LICENSE-CC0-1.0.txt, https://unfairly.ai/steal/design/assets/photography/NOTICE-NASA.txt
- Files:
  - `workshop` (reportage, focal 56% 24%): A bagpipe maker holds up a chanter for a visitor in his workshop, pipes hanging behind them. Jaime Pereira, CC0 1.0, https://commons.wikimedia.org/wiki/File:Vitor_Felix_e_Jo%C3%A3o_Pimentel_na_Oficina_de_M%C3%BAsica.jpg. https://unfairly.ai/steal/design/assets/photography/workshop-640.avif, https://unfairly.ai/steal/design/assets/photography/workshop-640.webp, https://unfairly.ai/steal/design/assets/photography/workshop-640.jpg, https://unfairly.ai/steal/design/assets/photography/workshop-1280.avif, https://unfairly.ai/steal/design/assets/photography/workshop-1280.webp, https://unfairly.ai/steal/design/assets/photography/workshop-1280.jpg
  - `creek` (reportage, focal 28% 40%): A hiker with two poles walks a log bridge over a lily pond while a friend photographs him. Vsatinet, CC0 1.0, https://commons.wikimedia.org/wiki/File:Crossing_a_creek.jpg. https://unfairly.ai/steal/design/assets/photography/creek-640.avif, https://unfairly.ai/steal/design/assets/photography/creek-640.webp, https://unfairly.ai/steal/design/assets/photography/creek-640.jpg, https://unfairly.ai/steal/design/assets/photography/creek-1280.avif, https://unfairly.ai/steal/design/assets/photography/creek-1280.webp, https://unfairly.ai/steal/design/assets/photography/creek-1280.jpg
  - `snow` (landscape, focal 86% 74%): Hikers walk down a snowy ridge below dark mountains. DimiTalen, CC0 1.0, https://commons.wikimedia.org/wiki/File:Hiking_down_the_C%C3%B4tes_Souveraines,_Huez_and_Villard-Reculas,_2026.jpg. https://unfairly.ai/steal/design/assets/photography/snow-640.avif, https://unfairly.ai/steal/design/assets/photography/snow-640.webp, https://unfairly.ai/steal/design/assets/photography/snow-640.jpg, https://unfairly.ai/steal/design/assets/photography/snow-1280.avif, https://unfairly.ai/steal/design/assets/photography/snow-1280.webp, https://unfairly.ai/steal/design/assets/photography/snow-1280.jpg
  - `room` (interior, focal 47% 52%): A period living room in daylight: a round table, a tall wardrobe and a patterned tile floor. יעקב (Yaakov), CC0 1.0, https://commons.wikimedia.org/wiki/File:Living_room_in_Beit_HaRishonim_(Herzliya)_7887.jpg. https://unfairly.ai/steal/design/assets/photography/room-640.avif, https://unfairly.ai/steal/design/assets/photography/room-640.webp, https://unfairly.ai/steal/design/assets/photography/room-640.jpg, https://unfairly.ai/steal/design/assets/photography/room-1280.avif, https://unfairly.ai/steal/design/assets/photography/room-1280.webp, https://unfairly.ai/steal/design/assets/photography/room-1280.jpg
  - `loafer` (still-life, focal 58% 56%): A brown leather penny loafer, side on, on a white background. Wikipedia-ce, CC0 1.0, https://commons.wikimedia.org/wiki/File:A_Penny_Loafer.jpg. https://unfairly.ai/steal/design/assets/photography/loafer-640.avif, https://unfairly.ai/steal/design/assets/photography/loafer-640.webp, https://unfairly.ai/steal/design/assets/photography/loafer-640.jpg, https://unfairly.ai/steal/design/assets/photography/loafer-1280.avif, https://unfairly.ai/steal/design/assets/photography/loafer-1280.webp, https://unfairly.ai/steal/design/assets/photography/loafer-1280.jpg
  - `coffee` (still-life, focal 44% 40%): Coffee with milk in a white mug on a wooden table. Kurt Kaiser, CC0 1.0, https://commons.wikimedia.org/wiki/File:Coffee_in_a_mug.jpg. https://unfairly.ai/steal/design/assets/photography/coffee-640.avif, https://unfairly.ai/steal/design/assets/photography/coffee-640.webp, https://unfairly.ai/steal/design/assets/photography/coffee-640.jpg, https://unfairly.ai/steal/design/assets/photography/coffee-1280.avif, https://unfairly.ai/steal/design/assets/photography/coffee-1280.webp, https://unfairly.ai/steal/design/assets/photography/coffee-1280.jpg
  - `aurora` (aerial, focal 55% 62%): The US Midwest at night from the International Space Station, city lights under a green aurora. Mike Fossum, NASA, Public domain (NASA), https://images.nasa.gov/details/iss029e012564. https://unfairly.ai/steal/design/assets/photography/aurora-640.avif, https://unfairly.ai/steal/design/assets/photography/aurora-640.webp, https://unfairly.ai/steal/design/assets/photography/aurora-640.jpg, https://unfairly.ai/steal/design/assets/photography/aurora-1280.avif, https://unfairly.ai/steal/design/assets/photography/aurora-1280.webp, https://unfairly.ai/steal/design/assets/photography/aurora-1280.jpg

### Unsplash API

- License: Unsplash License (https://unsplash.com/license)
- Version: API v1, read 2026-10-29
- Suits: Real-world scenes, people at work, places; large, current catalog.
- Not for: Re-hosting, building a gallery of its photos, or selling unaltered prints.
- Knobs: query; orientation: landscape, portrait, squarish; color: black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue; content_filter: low or high; imgix on urls.raw: w, h, fit, crop, fm, q, auto=format, dpr
- How: At runtime, through a server proxy holding the key: search, hotlink the returned photo.urls (keep ixid), credit the photographer and Unsplash with links carrying ?utm_source=<app>&utm_medium=referral, and call links.download_location when a photo is chosen. Demo keys allow 50 requests an hour, production 1,000.
- Terms: https://help.unsplash.com/en/articles/2511245-unsplash-api-guidelines, https://unsplash.com/documentation

### Pexels API

- License: Pexels License (https://www.pexels.com/license/)
- Version: API v1, read 2026-10-29
- Suits: Lifestyle, food, work scenes; ready-cropped portrait and landscape files.
- Not for: Redistributing on another stock or wallpaper platform, implying the people endorse the product, use in a trademark.
- Knobs: query; orientation: landscape, portrait, square; size: large, medium, small; color: name or hex; locale; per_page up to 80
- How: At runtime: show a prominent link to Pexels, credit as "Photo by <name> on Pexels" linked to the photo page, and pick from src (original, large2x, large, medium, small, portrait 800×1200, landscape 1200×627, tiny). 200 requests an hour, 20,000 a month.
- Terms: https://www.pexels.com/api/documentation/

### Openverse

- License: CC0 and Public Domain Mark (filter) (https://creativecommons.org/publicdomain/zero/1.0/)
- Version: API v1, read 2026-10-29
- Suits: Searching many open collections at once, filtered to no-attribution licenses.
- Not for: Trusting the index: each result's license is the source's claim.
- Knobs: q; license=cc0,pdm; source; aspect_ratio; size
- How: GET api.openverse.org/v1/images/?q=<query>&license=cc0,pdm, then open each result's foreign_landing_url and confirm the license there before use. Anonymous: 20 requests a minute, 200 a day (from the API's response headers).
- Terms: https://api.openverse.org/v1/

### Wikimedia Commons

- License: Per file; filter to CC0 and public domain (https://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia)
- Version: MediaWiki API, read 2026-10-29
- Suits: Documentary photos of real places, crafts, events and objects.
- Not for: Files tagged with personality rights for ads; museum objects whose own copyright isn't settled.
- Knobs: search with incategory:CC-zero; prop=imageinfo with extmetadata (LicenseShortName, Artist, Restrictions); thumb widths 640, 1280, 1920
- How: Read the license on each file's description page. Attribution isn't required for public domain but Commons recommends it, and personality rights and trademarks still apply. Skip any file with a Restrictions value.
- Terms: https://commons.wikimedia.org/wiki/Commons:Reusing_content_outside_Wikimedia

### NASA Image and Video Library

- License: Generally not copyrighted in the US (https://www.nasa.gov/nasa-brand-center/images-and-media/)
- Version: images-api.nasa.gov, read 2026-10-29
- Suits: Earth, space, aerial and science imagery.
- Not for: Anything that implies NASA endorses a product; the NASA insignia; current astronauts' likeness in ads.
- Knobs: q; media_type=image; center; year_start, year_end
- How: GET images-api.nasa.gov/search, then /asset/<nasa_id> for sizes. Credit NASA as the source.
- Terms: https://www.nasa.gov/nasa-brand-center/images-and-media/

## Runtime

Unsplash and Pexels are runtime-only: search through a server proxy that holds the key, hotlink the returned URLs, show the credit, and (Unsplash) call download_location when a photo is chosen. Never download and re-host their files.

## Not published anywhere we read

- No system we read publishes grade strengths, grain amounts or scrim opacities; ours are labelled our recipe.
- No system publishes a threshold for a quiet text zone; 0.06 luminance standard deviation is our measure.
- Mozilla's Foundation photography page is offline; we read the February 2025 archive.
- The Mozilla, Mailchimp and Dropbox brand books publish no photo treatment, so the pick table decides for all three.
- No Unsplash or Pexels key is configured, so this page draws only hosted CC0 and public-domain photos.
