---
id: pystac-ext-table
version: "1.2.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-table — Table extension for PySTAC

License: permissive · Maintenance: active · Downloads: 4.0M/mo

## What it is and what it does

pystac-ext-table is a PySTAC extension package that adds support for the STAC Table Extension specification (v1.2.0). It allows you to annotate tabular data assets in a STAC catalog with structured metadata—column names and types, row counts, primary and foreign key definitions, and storage format details. The package is a thin wrapper around the extension schema, designed to integrate seamlessly with pystac-core so you can build and query STAC catalogs that properly describe tabular datasets.

You install it alongside pystac-core and use it to attach table metadata to assets in your catalog items. The package is actively maintained, production-stable, and requires Python 3.10 or later. It has no external system dependencies and installs as a pure Python wheel.

Use it for:

- Catalog CSV, Parquet, or database exports as STAC items with column and row metadata.
- Build searchable STAC catalogs for tabular geospatial or scientific datasets with schema annotations.
- Describe primary/foreign key relationships in multi-table datasets within a STAC catalog.
- Standardize table metadata across a data repository using the STAC Table Extension spec.

## Worth the install?

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

Extends PySTAC to describe tabular data assets with column definitions, row counts, keys, and storage formats via the Table Extension specification.

Yes, if you are building or working with STAC catalogs that include tabular data. The package is stable, actively maintained, has no known vulnerabilities, and adds the minimal overhead needed to comply with the Table Extension specification. Install it only if you actually need to describe table assets; it is not useful in isolation from pystac-core.

## Install

pip install pystac-ext-table
uv add pystac-ext-table
poetry add pystac-ext-table

## Installing pystac-ext-table

Before you install: Low friction: pure Python wheel with a single runtime dependency (pystac-core). Actively maintained with a release 4 days old and recent commits; supports Python 3.10–3.13.

License in practice: Apache-2.0 (permissive): you may use, modify, and distribute this package freely in commercial and private projects, provided you include the license notice.

Quickstart:

pip install pystac-ext-table

import pystac
from pystac_ext_table import Table

# Create or load a STAC item and add table metadata via the extension
item = pystac.Item(...)
table_ext = Table.from_dict({...})  # Populate with column, row, and key definitions
item.add_extension(table_ext)

Requires Python 3.10 or later and pystac-core as a runtime dependency.

Verify before relying:

- Whether the package is compatible with all pystac-core versions or requires a specific range.
- Whether the Table Extension v1.2.0 schema covers all common tabular metadata use cases you need.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

STAC table extension, tabular data metadata, PySTAC table assets, column definitions STAC, table extension schema, structured data catalogs, stac-extension, metadata-schema, geospatial-data

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