# Collage: web app and CLI

## What it does
Arranges a set of images into a single collage PDF page. Upload a collection of JPG photos. The AI analyzes content, colors, and dimensions, arranges them into a balanced layout, and exports a high‑resolution PDF ready for printing.

## Inputs and limits
**Command line options**

* `--page-size-name` (string, default "A4"): Output page size (default 'A4').
* `--title` (string, default ""): Optional collage title.
* `--max-images-per-page` (int, default 6): Maximum images per page (default 6).

## Web app
Open the web app: [Make a PDF collage](https://products.documentize.ai/collage).

## Command line (CLI)
The `Documentize.Collage` plugin: Arranges a set of images into a single collage PDF page.

Replace `input-file` with your file and add the options listed above after `--task-id job1`.

```bash
# Linux / macOS (needs the .NET 10 runtime and documentize.lic next to the DLL)
export PLUGIN_INPUT_DIR=./work/input
export PLUGIN_OUTPUT_DIR=./work/output
mkdir -p "$PLUGIN_INPUT_DIR/job1"
cp input-file "$PLUGIN_INPUT_DIR/job1/"
dotnet Documentize.Collage.dll --task-id job1
ls "$PLUGIN_OUTPUT_DIR/job1"
```

```powershell
# Windows PowerShell
$env:PLUGIN_INPUT_DIR  = "$PWD\work\input"
$env:PLUGIN_OUTPUT_DIR = "$PWD\work\output"
New-Item -ItemType Directory -Force "$env:PLUGIN_INPUT_DIR\job1" | Out-Null
Copy-Item input-file "$env:PLUGIN_INPUT_DIR\job1\"
dotnet Documentize.Collage.dll --task-id job1
Get-ChildItem "$env:PLUGIN_OUTPUT_DIR\job1"
```

All command line plugins: [Documentize CLI plugins](https://products.documentize.ai/pdf-cli).

## Related guides

* [Add tables to PDF files: web app and CLI](/docs/add-table)
* [Add Table of Contents to PDF: web app and CLI](/docs/add-toc)
* [Generate PDF table of contents: web app, CLI and MCP](/docs/table-of-contents)
* [Flatten PDF files: web app, CLI, MCP and C# (FOSS)](/docs/flatten)

## Verification status
**Not verified.** This guide is built from the product documentation and the app's own page. The commands and calls above have not been run successfully, so they may need changes, and the file names in them are placeholders. Written on 2026-11-04; a verified guide replaces this page when the app passes the checks.