All Collections
Creating Turtl Docs
Best practices
How to optimize load speed of a Turtl Doc?
How to optimize load speed of a Turtl Doc?

What Turtl does to optimize load speed and what users can do to further enhance it

Nastja Sodin avatar
Written by Nastja Sodin
Updated over a week ago

Evaluating Turtl Doc load speed can be particularly challenging due to their interactive features, making it difficult to establish a uniform benchmark for comparison. When clients experience slow loading times, it is recommended to conduct a thorough examination of each individual Doc. In many cases, the main contributing factor to slow loading is the presence of oversized imagery.

Turtl Docs can be sluggish because they're interactive, making benchmarking difficult and requiring individual review, with oversized imagery frequently being the root cause of slow loading times.

To ensure optimal loading speed for Turtl Docs, it is important to balance the quality (size) of media with the user experience.

Turtl Docs are already optimized to deliver the best possible user experience, but there are ways to further enhance loading speed while maintaining satisfactory quality.

How is load speed optimized by default?

Prioritized loading approach

Turtl Docs utilize a prioritized loading approach to enhance user experience. Critical assets necessary for displaying the Doc are loaded first. Initially, only the text content of the Doc is downloaded, along with the images required for the initial page. Other assets are loaded in the background, ensuring a smooth and uninterrupted interaction.

Customizing asset sizes

While some customers prioritize quality over loading speed and may prefer larger file sizes for their Docs, it is important to consider individual preferences. To cater to different needs, Turtl allows checking or unchecking optimization of the assets.

How can load speed be further optimized?

Use appropriate format

A fundamental knowledge of image formats is crucial when optimizing images, with JPEG (.jpg) generally being the go-to choice for photos, images featuring gradients, and those containing a wide array of colors, whereas PNG (.png) is better suited for images characterized by a restricted color palette, such as logos, and those requiring transparency.

External compression for media

Turtl employs a compression algorithm that prioritizes quality over size, but additional compression tools can be utilized if desired.

We recommend the following online tools:

Use appropriate dimensions

Further space efficiency can be attained by adjusting the image size to optimal dimensions before uploading.

Avoid Large GIFs and 4K Videos

To achieve the best performance, it is advisable to stay under 10MB when uploading GIFs or 4K for videos in Turtl Docs to prevent unnecessary delays. These files can significantly impact loading speed and hinder the overall user experience.


By following these recommendations and considering individual preferences, you can optimize the loading speed of Turtl Docs while maintaining a satisfactory user experience.

Did this answer your question?