AWI Staff Documentation
Internal Use Only

Images & Media

Updated June 2026 · Getting Started

Reference the mapping spreadsheet for all image placements—it contains the correct URL, photo credit, file name, and image size for each page.

On This Page

→ Media Library → Saving Images for Web → Adding Policy Page Images → Adding Program & Campaign Images

Media Library

1

Check for duplicates before uploading

Search the Media Library for the filename before uploading. To find a file's exact name on your computer, right-click it and choose Get Info (Mac) or Properties (Windows) to see the full filename.

2

Always add Alt Text and Photo Credit

After uploading, fill in Alt Text and Title (same value). In the Description field add "Photo by [Name]". These are required on every image.

Alt text should describe the subject specifically—species, condition, and context. Keep it under 10 words. Never use "image of," "photo of," or the filename.

Sow confined in gestation crate ✓ Wild horse grazing on federal rangeland ✓ Chickens crowded in battery cages ✓ Brown bear foraging in forest ✓ Image of a pig ✗ Photo ✗ AWI animal ✗ DSC_0042.jpg ✗
Replacing existing media: WordPress has a Replace Media feature that swaps a file while keeping the same attachment ID—meaning every page using that image updates automatically. Use this when updating an existing image rather than uploading a new file. To use it: open the image in the Media Library, click Replace Media, and upload the new file.

Saving Images for Web

Use File > Export > Export As in Adobe (not Save for Web, which is legacy).

Naming Conventions

  • Don't rename unless necessary—the existing filename is a unique identifier.
  • New images: 3–4 words separated by hyphens describing the image. No "awi" or abbreviations.
  • No special characters: use inside-hero-2x.jpg not inside-hero@2x.jpg.

JPEG Export Settings

Quality

60–80% for most images. 80% is usually the sweet spot.

Color Space

Always enable "Convert to sRGB" for consistent color across devices.

Progressive

Enable for images over 10KB.

Scale / Retina

Export at 2x for Retina displays. Size per tab in the spreadsheet cell D2.

← Press Releases
Naming Conventions →