# Preview Images

PlainSpeak Accessible Geospatial Companion can show static preview images beside the accessible status results. These images are optional, but they help sighted users recognize the reporting area before opening the interactive application.

## Recommended WordPress Media Library Workflow

1. Upload preview images to **Media → Library**.
2. Open an uploaded image and copy its file URL.
3. Use the folder portion of that URL as the **Preview Base URL**.
4. Keep the original/full-size filenames; do not use WordPress thumbnail URLs such as `-300x169`.

Example image URL:

```text
https://example.com/wp-content/uploads/2026/06/county-sonoma.jpg
```

Preview Base URL to enter in PlainSpeak:

```text
wp-content/uploads/2026/06/
```

PlainSpeak will also quietly normalize these pasted forms to the same stored value:

```text
/wp-content/uploads/2026/06/
./wp-content/uploads/2026/06/
```

## Preview Base URL

Use the WordPress uploads folder path that contains the preview images.

```text
wp-content/uploads/2026/06/
```

PlainSpeak appends the expected filename automatically for detail-area previews.

## Expected Filenames

Common examples:

```text
county-sonoma.jpg
county-alameda.jpg
statewide-california.jpg
placeholder-california.png
```

## Placeholder Image URL

Use the image shown before a preview loads or when a preview is unavailable.

```text
wp-content/uploads/2026/06/placeholder-california.png
```

## Fallback Image URL

Use the image shown when no matching preview image can be loaded.

```text
wp-content/uploads/2026/06/placeholder-california.png
```

## Notes

Media Library files remain in WordPress if PlainSpeak is deleted. PlainSpeak removes its own settings on uninstall, but it does not delete administrator-uploaded images.
