> For the complete documentation index, see [llms.txt](https://docs.santacruzsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.santacruzsoftware.com/printui/guides/images-and-galleries.md).

# Work with Images and Galleries

## Prepare template images

Use linked images, not pasted embedded images. Keep links local before upload.

For print output, prepare images around 200 to 300 dpi at the size they are placed. Oversized images slow upload, download, editor rendering, and final output generation.

Use JPEG for most photographic images. Use PNG when transparency is required.

## Replacement images

The editor can allow users to replace image frames from their computer, an approved gallery connector, social galleries, or connected storage services.

Use `imagePpiLimit` and `limitImageResize` when replacement images must maintain minimum resolution.

Use `placeImagesFullSize` when replacement images should be placed at their defined size rather than fit to the existing frame.

## Gallery connectors

A gallery connector supplies approved image choices to the Image Gallery Browser. Gallery qualifiers can pass information such as template name, user ID, or campaign metadata to the connector.

Frame keywords can further filter image choices for a selected frame. This requires connector support.

## Replaceable backgrounds

The replaceable background feature is deprecated, but older workflows may still use it. A replaceable background must be on an editable layer, not the Background or Foreground layer.

If the background is an image, the gallery opens for replacement. If it is a rectangle or similar object, a color picker opens.

Separate run-time options can define background-gallery connector behavior.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.santacruzsoftware.com/printui/guides/images-and-galleries.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.