Last updated: August 28, 2025

<span aria-hidden="true" id="introducing-turbo-mode-for-documentthumbs"></span>

# Introducing Turbo Mode for /document/thumbs

![Kevin van Zonneveld](/assets/images/teammates/avatar-kvz-4.jpg?dpl=dpl_6nhQNS5wkVkPZWuKMzXcWrAHNJL5)

**Kevin van Zonneveld**

Co-founder · Amsterdam, The Netherlands · Show bio

[](https://x.com/kvz)[](https://github.com/kvz)

We added a new Turbo mode for our [🤖 /document/thumbs](/docs/robots/document-thumbs.md) Robot. It emits page thumbnails as soon as they are ready instead of batching them at the end, so downstream Steps can start work earlier. This can reduce end-to-end time for multi‑page PDFs by up to ten times, depending on your workflow.

<span aria-hidden="true" id="what-is-turbo-mode"></span>

## What is Turbo Mode?

Turbo mode lets Transloadit parallelize or stream work so results become available earlier. We first introduced it for our [🤖 /video/encode](/docs/robots/video-encode.md) and[🤖 /video/concat](/docs/robots/video-concat.md) Robots, and are now bringing similar benefits to document thumbnailing. See our [Turbo mode FAQ](/docs/faq/turbo-mode.md) to find out how it works.

<span aria-hidden="true" id="how-it-works-for-documents"></span>

## How it works for documents

Turbo mode is enabled by default for document thumbnails. Turbo mode allows the[🤖 /document/thumbs](/docs/robots/document-thumbs.md) Robot to emit a result for each page as soon as that page is processed. If you prefer batched results, you can opt out perStep by setting `turbo`: false.

Leaving Turbo mode enabled means:

* **Faster pipelines**: subsequent Steps (for example, image post-processing or storing) can begin while later pages are still being rendered.
* **Much faster resizing**: when you specify `width` and/or `height`, extracted pages are resized in parallel on remote machines rather than queued sequentially on a single machine (concurrency of 1). This results in a dramatic speedup that scales linearly with the number of pages.
* **Predictable ordering**: results are still sorted by page. You can also inspect`meta.thumb_index` to determine a page’s index.

This streaming behavior is especially useful for document viewers that need to show page previews as soon as possible, or pipelines in which every second matters between ‘upload’ and ‘first usable preview’.

<span aria-hidden="true" id="when-to-use-it-and-when-not-to"></span>

## When to use it (and when not to)

✅ **Time-sensitive workflows**: choose Turbo mode if you want the fastest possible time-to-first- preview, or if downstream work can run per page.

❌ **Cost-sensitive workflows**: for some pricing scenarios, earlier per‑page emission can be treated similarly to handling multiple inputs. If your primary goal is minimizing cost, consider opting out by setting `turbo`: false. For details, see our [pricing docs](/docs/robots/pricing.md).

<span aria-hidden="true" id="why-is-it-enabled-by-default"></span>

## Why is it enabled by default?

In our analysis of common setups, document thumbnails are small and inexpensive compared to video and other workloads. Enabling Turbo by default delivers meaningful latency gains while having a negligible impact on most invoices. If minimizing cost is your top priority, you can always opt out by setting `turbo` to `false`.

<span aria-hidden="true" id="example-assembly"></span>

## Example Assembly

Below is a minimal example that converts a multi‑page PDF into 600‑px wide page thumbnails and stores them with an index in the file path. Turbo mode is enabled by default; no additional parameter is needed. To opt out, set `turbo`: false. Keep an eye on `meta.thumb_index` for page‑aware filenames.

```json
{
  "steps": {
    "thumbs": {
      "use": ":original",
      "robot": "/document/thumbs",
      "width": 600,
      "resize_strategy": "fit"
    },
    "store": {
      "use": "thumbs",
      "robot": "/s3/store",
      "path": "docs/${file.original_basename}/page-${meta.thumb_index}.${file.ext}"
    }
  }
}

```

<span aria-hidden="true" id="availability"></span>

## Availability

Turbo mode for document thumbnails is available today and enabled by default. If you want to opt out account‑wide, please reach out to [hello@transloadit.com⁠](mailto:hello@transloadit.com) and we will help you set it up.

<span aria-hidden="true" id="learn-more-and-try-it"></span>

## Learn more and try it

* Read the [🤖 /document/thumbs](/docs/robots/document-thumbs.md) Robot docs.
* Review the [Turbo mode FAQ](/docs/faq/turbo-mode.md).
* New to Transloadit? [Sign up](/c/signup/) and start processing in minutes.

Enjoy, and use responsibly!

[#performance](/blog/tags/performance.md)[#pricing](/blog/tags/pricing.md)[#document-processing-service](/blog/tags/document-processing-service.md)[#document-thumbs-robot](/blog/tags/document-thumbs-robot.md)

### 👩‍💻 Join 20k+ developers

Sign up for our [monthly newsletter](/newsletters.md) to receive direct links to 3 exclusive tech — and 2 product updates. No less, no more.

Your email:

Get access

## File uploading and encoding. Made simple.

Transloadit streamlines file handling for developers, trusted by brands like Coursera and The New York Times. We’re known for a reliable API, top-notch support, and a strong commitment to open source, with projects like [Uppy⁠](https://uppy.io) and [Tus⁠](https://tus.io) setting standards in file processing.

[Sign up](/c/)[Book a Demo](https://survey.typeform.com/to/kRg47Xi5)

No credit card needed · 5 GB included in the free plan

Cancel anytime