Skip To Content

00149: The tile cache size that will be generated exceeds the available disk space on the server

The estimated cache size for this map exceeds the available disk space on the server.


If possible, add the necessary disk space to the server. If adding disk space to the server is not possible, you can use a number of caching strategies in order to reduce the size of the cache. These include using a feature class to define an area of interest in which to create tiles, using on-demand caching for less-viewed areas, and cutting down on the visible scale ranges of the cache. You can use these individually, or in combination.

Learn more about strategies for creating map cache tiles

More information

Map and image service caches can take a lot of server resources to create and store. There are a number of things you can do to reduce the overall size of your cache.

  • Feature class boundaries

    Caching by feature class boundary allows you to create tiles only in the places where you need them, avoiding empty or uninteresting areas. For example, if you are caching a country, you might supply a feature class of major urban areas. By doing so, you are requesting that the server only pre-create tiles that cover those urban areas. The rest of the areas can be cached on demand when requested by clients. This can save you time and disk space that would be consumed by creating unneeded tiles in rural areas.

    The image below shows a theoretical grid of tiles that would be created if the feature class contained just the state of California. Unneeded tiles in the ocean and in neighboring states are not created. These unneeded tiles would have been included if the default rectangular extent were used.

    Illustration of tile creation based on feature boundaries

    Learn more about map caching based on feature boundaries

  • On-demand caching

    On-demand caching is the act of creating tiles the first time they are requested by a client, instead of pre-creating the tiles. On-demand caching is a good way to save space and cache creation time, but the first person who navigates to the map area has to wait for the tiles to be drawn. The image below shows a map where commonly viewed areas can have tiles pre-created and the tiles for less-viewed areas are created on demand.

    A map showing how commonly viewed areas can have tiles pre-created

    When used wisely, on-demand caching can save you much time and disk space. Most maps show some area that is barren, unusable, or uninteresting to the map audience, especially at large scales (zoomed in). Caching on demand relieves you of the burden of creating and storing these unneeded tiles but leaves the possibility that a user could still view the area if needed.


    Although on-demand caching is a useful feature, it can put an unnecessary hit on performance when misused or overused.

    Learn more about on-demand caching

  • Cache scale ranges

    When choosing the scale levels for your cache, remember that the closer you zoom in on the map, the more tiles are required to cover the map extent, and the longer it will take your cache to generate. Every time you halve the scale's denominator, it takes four times as many tiles to cover a square area of the map. For example, a square map at 1:500 scale contains four times more tiles than a map at 1:1,000 scale, and a square map at 1:250 contains 16 times more tiles than a map at 1:1,000 scale.

Learn more about planning a map cache

In this topic
  1. Solution
  2. More information