---
title: "Cache files"
source: https://dev.pageseeder.com/reference/folders_and_files/state_folder/cache_files.html
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~808
---

# Cache files

`/WEB-INF/state/cache`

To improve both security and performance, PageSeeder stores files in the cache folder. These include image thumbnails and the system cache. There is generally no need to change these files manually.

> **Note:** The file organization and format of the cache files might change between releases and is handled automatically by PageSeeder.





## Image thumbnails

When a user views an image, PageSeeder automatically generates a low resolution thumbnail of it to make serving the image faster.

You can safely delete files in the `/WEB-INF/state/cache/thumbnail` folder** **as they are automatically recreated by PageSeeder, but this might affect performance if your system contains a lot of images.



> **Note:** PageSeeder automatically deletes associated image thumbnails when an image or group is archived or deleted.



## System cache

PageSeeder automatically stores the following system files using [ehcache](https://www.ehcache.org/).

| Cache | Key | Contents | Purpose |
| --- | --- | --- | --- |
| account-lockout | Username | Failed sign in attempts info (object) | security |
| client-origins | Origin URL | CORS support (boolean) | performance |
| edit-comparisons | Edit IDs + dates | Diff between edits (XML) | performance |
| external-favicons | Host | Favicons used in URLs (Image) | performance |
| file-inspection | File path | Result of file inspection (object) | performance |
| group-state | Group ID | Dates of latest updates (object) | performance |
| membership-etags | Member ID | Etag (long) | performance |
| profile-pictures | Member ID | Profile picture (image) | performance |
| publication-tocs | Publication ID + host (+ version) | Table of Contents of publications (object) | performance |
| publication-tocs-version | performance |
| reset-password-lockout | Email | Failed sign in attempts info (object) | security |
| url-hosts | Host | Date last checked (long) | performance |
| url-metadata | Host | Metadata (object) | performance |
| user-details | Member ID | Group flags (object) | performance |
| validation-results | Group ID + URI ID | Schematron validation results (object) | performance |
| webhook-events | Event ID | Webhook events (object) | performance |
| webhook-failed-jobs | Job ID | Webhooks failed jobs (object) | performance |
| webhook-jobs | Job ID | Webhooks jobs (object) | performance |
| xml-documents | Group ID + URI ID | PSML content (object) | performance |

> **Warning:** Manually modifying or deleting these files might corrupt your system.

Use the **Server status \> Caching** page in the system administration to view and manage the cache contents.

## API services

The following services let you manage the cache more effectively:

- [/caches \[GET\]](../../../api/services/cache-summary-GET.md)
- [/caches/clear \[POST\]](../../../api/services/clear-all-cache-POST.md)
- [/caches/\{name\} \[GET\]](../../../api/services/get-cache-GET.md)
- [/caches/\{name\}/clear \[POST\]](../../../api/services/clear-cache-POST.md)
- [/caches/\{name\}/elements \[GET\]](../../../api/services/list-cache-elements-GET.md)
- [/caches/\{name\}/elements/\{key\}/remove \[POST\]](../../../api/services/remove-cache-element-POST.md)