Skip to main content

Scheduled Task: Auto Build Thumbnail

Distributor guide to the scheduled task that builds image thumbnails for documents in Encompass, and why a document shows a Failed thumbnail status. Requires v26.07+.

B
Written by Bailey Naas-Thornton

Minimum Version Required: 26.07

Steps

What the Auto Build Thumbnail Scheduled Task Does

  1. This task runs automatically in the background on a recurring schedule. It does not require a customer to start it, and there is nothing to configure or click to run it.
    ​
    ​

  2. Each time it runs, it checks the Documents table for image files (PNG, JPG, BMP, GIF, JPEG, TIF, or TIFF) that were added or changed since the task's last successful run and still need a thumbnail (their thumbnail status is New or Failed).
    ​
    ​

  3. For each matching image, the task downloads the original file and creates a smaller preview copy (a thumbnail), sized to a maximum height of 300 pixels so it loads quickly wherever Encompass displays image previews.
    ​
    ​

  4. If the thumbnail is meaningfully smaller than the original image, it is saved as a separate file and used as the preview. If the original image is already small, Encompass simply reuses the original as its own preview instead of creating an extra file.
    ​
    ​

  5. The task then updates the document's thumbnail status to Completed so it will not be processed again.
    ​
    ​

  6. If a thumbnail cannot be created — for example, because the image file is corrupted or unreadable — the task marks the document's thumbnail status as Failed and logs the reason so the issue can be investigated.

Best Practices

  • It's normal to see Auto Build Thumbnail listed in the Scheduled Tasks table — it runs on a regular interval as part of normal system operation and needs no action from you.
    ​
    ​

  • Leaving this task enabled keeps image previews loading quickly across Encompass, since the resizing work is done ahead of time instead of on demand.
    ​
    ​

  • If a document repeatedly shows a Failed thumbnail status, the underlying image file is likely damaged or in an unsupported format

Did this answer your question?