---
id: titiler-extensions
version: "2.2.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# titiler-extensions — Extensions for TiTiler Factories.

License: permissive · Maintenance: active · Downloads: 89.3K/mo

## What it is and what it does

titiler-extensions provides a collection of pre-built extension classes that plug into TiTiler's TilerFactory to add specialized endpoints for geospatial tile serving. It extends the base TiTiler framework with support for COG (Cloud Optimized GeoTIFF) validation, HTML viewers for COGs and STAC items, and OGC Web Map Service (WMS) endpoints. The package is designed to work with titiler-core and typing-extensions, allowing you to compose tile server functionality by registering extensions at factory creation time.

You use it by importing one or more extension classes, passing them to a TilerFactory's extensions parameter, and then registering the factory's router with your application. The package also provides a base FactoryExtension class for building your own custom extensions, letting you add arbitrary endpoints that reuse the factory's dependency injection system and reader infrastructure.

Use it for:

- Add a /validate endpoint to a tile server that returns COG metadata and validation info.
- Serve an interactive HTML viewer for individual Cloud Optimized GeoTIFFs without writing custom endpoints.
- Expose STAC item collections through a /viewer endpoint for browsing and previewing raster data.
- Implement OGC Web Map Service (WMS) GetTile and GetCapabilities endpoints on a tile server.
- Build custom tile endpoints (e.g., thumbnails, statistics) by subclassing FactoryExtension and reusing factory dependencies.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides pluggable extension classes for TiTiler's TilerFactory to add specialized endpoints like COG validation, STAC viewing, WMS support, and custom tile server functionality.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and provides a clean plugin architecture for extending TiTiler with common geospatial endpoints. Install it if you are building a tile server and want to add COG validation, STAC viewing, WMS support, or custom tile endpoints without writing boilerplate.

## Install

pip install titiler-extensions
uv add titiler-extensions
poetry add titiler-extensions

## Installing titiler-extensions

Before you install: Low install friction with only 2 runtime dependencies (titiler-core and typing-extensions). Actively maintained with a recent release 16 days ago and ongoing commits; the parent repository has 1145 stars.

License in practice: MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice in distributions.

Quickstart:

pip install titiler.extensions

from titiler.core.factory import TilerFactory
from titiler.extensions import cogValidateExtension

tiler = TilerFactory(
    router_prefix="/cog",
    extensions=[cogValidateExtension()]
)

Requires Python 3.11 or later; titiler-core must be installed as a runtime dependency.

Verify before relying:

- Whether the cogValidateExtension's rio-cogeo dependency is automatically installed or requires manual installation via titiler.extensions["cogeo"].
- Performance characteristics when multiple extensions are registered on a single TilerFactory.
- Compatibility with specific versions of titiler-core beyond the declared runtime dependency.
- Whether all extensions work with all supported Python versions (3.11, 3.12, 3.13, 3.14).

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 89.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

titiler factory extensions, cog tile server endpoints, stac viewer extensions, wms web map service tiles, custom tiler endpoints, geotiff tile server plugins, raster tile factory extensions, geospatial-tiles, cloud-optimized-geotiff

[View on SkillFed](https://skillfed.io/packages/titiler-extensions) · [View on PyPI](https://pypi.org/project/titiler-extensions/)