OPF Image Treatment

Collage Grid

Multiple images are arranged in a disciplined grid to show breadth, variety, or momentum.

collage-gridNative OPF

Best Fit

Portfolio slides, social proof, campaign mood boards, and community snapshots.

Photography Guidance

Curate images around one visual theme. Keep crop ratios consistent and avoid mixing screenshots with photography unless that contrast is the message.

Avoid

Avoid collage grids for executive decision slides or when one image is clearly the hero.

Treatment Practices

1

Use a grid, not a scattered pile.

2

Balance bright and dark images across the composition.

3

Keep captions off the grid unless every image needs one.

OPF Config

image-treatments:collage-grid
Open Presentation Format
{
  "slide": {
    "layout": "image-grid",
    "elements": [
      {
        "id": "grid-image-1",
        "type": "image",
        "src": "https://example.com/photo-1.jpg",
        "alt": "Grid image one",
        "fit": "cover",
        "position": {
          "x": 8,
          "y": 14
        },
        "size": {
          "width": 38,
          "height": 30,
          "unit": "%"
        }
      },
      {
        "id": "grid-image-2",
        "type": "image",
        "src": "https://example.com/photo-2.jpg",
        "alt": "Grid image two",
        "fit": "cover",
        "position": {
          "x": 50,
          "y": 14
        },
        "size": {
          "width": 38,
          "height": 30,
          "unit": "%"
        }
      },
      {
        "id": "grid-image-3",
        "type": "image",
        "src": "https://example.com/photo-3.jpg",
        "alt": "Grid image three",
        "fit": "cover",
        "position": {
          "x": 8,
          "y": 50
        },
        "size": {
          "width": 38,
          "height": 30,
          "unit": "%"
        }
      },
      {
        "id": "grid-image-4",
        "type": "image",
        "src": "https://example.com/photo-4.jpg",
        "alt": "Grid image four",
        "fit": "cover",
        "position": {
          "x": 50,
          "y": 50
        },
        "size": {
          "width": 38,
          "height": 30,
          "unit": "%"
        }
      }
    ]
  }
}
Open in OPF Playground

Preview this config live at pptx.dev/playground.

Related How-To Articles

How to Add Images to PowerPoint Slides with pptx.dev

Learn how to embed images in PowerPoint presentations using the pptx.dev API — including cropped, fitted, and multi-image layouts.

How to Place, Size, and Overlay Images in PowerPoint

Master image placement, sizing, cropping, and overlay techniques to create polished, professional presentation slides.

General Image Rules

1

Crop with intent

Choose fit, position, and size based on the subject and message, not just available space.

2

Protect readability

Text over images needs enough contrast, an intentional overlay, or a separate text surface.

3

Respect image truth

Avoid filters or crops that distort evidence, screenshots, charts, or compliance imagery.

4

Keep a system

Use a small set of image treatments consistently so photo-heavy decks still feel coherent.