Content Editor Resources

Image and Media Guidelines

How to prepare, name, upload, and manage WordPress media without slowing pages down or turning the library into a junk drawer.

Media standards

Names. Sizes. Alt text. Licensing.


Keep media organized, accessible, lightweight, and safe to reuse across a professional WordPress site.

Media standards snapshot

Keep media organized, accessible, lightweight, and safe to reuse across the site.

Before uploadingWhy it matters
Use a clear file nameImproves organization and makes media easier to find later.
Resize oversized imagesPrevents heavy pages and slow loading.
Compress the fileReduces file size without visibly hurting quality.
Confirm usage rightsAvoids licensing, attribution, privacy, and brand problems.
Plan alt textSupports accessibility and clarifies image purpose.
Check reuseConfirms whether the image appears in a pattern, template, synced block, or shared page section.

File naming rules

  • Use descriptive words instead of camera file names.
  • Use lowercase letters, numbers, and hyphens.
  • Avoid spaces, special characters, and vague names.
  • Include the subject, page, product, service, or campaign when useful.
  • Do not upload files named image1.jpg, screenshot.png, or final-final-new.png.
Weak file nameBetter file name
IMG_4827.jpgdenver-office-team-meeting.jpg
homepagebanner.pnghome-page-consulting-hero.png
Screenshot 2026-05-14.pngwordpress-editor-featured-image-panel.png
logo-new-final.svgcompany-logo-primary.svg

Recommended image formats

FormatBest forAvoid using it for
JPGPhotos and complex imagesLogos, icons, or images that need transparency
PNGGraphics that require transparencyLarge photos when JPG or WebP would be smaller
WebPCompressed web imagesFiles that need maximum compatibility outside the website
SVGLogos, icons, and simple vector graphicsPhotos or complex illustrations
PDFDownloadable documentsContent that should be a normal web page

Image size guidelines

Image sizes should match the job. Oversized uploads slow pages down, waste storage, and force future editors to manage files that were never prepared for the web.

Use casePractical target
Hero or full-width imageAbout 1600-2400 px wide
Standard content imageAbout 1200-1600 px wide
Card or thumbnail imageAbout 600-1000 px wide
Logo or iconUse SVG when appropriate, or upload only the needed display size
PDF downloadCompress before upload and use a descriptive title

Alt text rules

Alt text should explain the purpose of an image for people who cannot see it. It is not a place for keyword stuffing, file names, or decorative filler.

Image typeAlt text approach
Informational imageDescribe the information or action shown.
Product or service imageIdentify the product, service, or context clearly.
Chart or diagramSummarize the important takeaway, not every visual detail.
Decorative imageUse empty alt text when the image adds no meaningful information.
Linked imageDescribe the destination or action of the link.

Upload workflow for editors

  1. Choose the right image for the page goal.
  2. Confirm the image can legally be used.
  3. Crop or resize the image before uploading.
  4. Compress the file.
  5. Rename the file using clear words and hyphens.
  6. Upload it to WordPress.
  7. Add alt text, title, caption, and credit when needed.
  8. Preview the page on desktop and mobile.

Captions, credits, and titles

  • Use captions when the image needs context, attribution, or explanation.
  • Do not use captions just to repeat the sentence above the image.
  • Include credits when licensing or editorial standards require attribution.
  • Use clear media titles inside WordPress so files are easier to search later.
  • Keep public-facing credits consistent across the site.

Licensing and usage rights

Every uploaded image should have a known source and clear usage rights. Do not pull images from search results, social media, competitor sites, or random PDFs unless the organization has permission to use them.

  • Use original company photography when possible.
  • Keep stock image licenses documented.
  • Check whether attribution is required.
  • Confirm that AI-generated or edited images are approved for the intended use.
  • Do not upload client, employee, or customer images without appropriate permission.

Common media mistakes

  • Uploading original camera files without resizing or compression.
  • Using vague file names that make the media library hard to search.
  • Reusing an image in a synced pattern or template without realizing it affects multiple pages.
  • Adding keyword-stuffed alt text that does not help users.
  • Uploading screenshots that expose private dashboards, customer data, or internal documents.
  • Using AI-generated or edited images that misrepresent real people, products, locations, or events.

Quick editor checklist

  • The file name is descriptive and uses hyphens.
  • The image is resized for web use.
  • The file is compressed.
  • The image has useful alt text or intentionally empty alt text.
  • Licensing and attribution are clear.
  • The image looks good on mobile.
  • The page still loads quickly after the image is added.

Related resources