Package datapane.client.api

API docs for Datapane Client

These docs describe the Python API for building Datapane documents, along with additional information on the Datapane Teams API.

Usage docs for Datapane can be found at

These objects are all available under the datapane module, via import datapane as dp (they are re-exported from datapane.client.api).

Datapane Reports API

The core document APIs are available for both Datapane Community and Datapane Teams, these are found in, including,

Datapane Teams

Additional API docs are found in datapane.client.api.teams that provide building, deployment, and sharing of data analytics apps and workflows

Note: These docs describe the latest version of the datapane API available on pypi

Latest release



Common objects …


Base classes …


Main Document API module, includes both the core Report object, and the blocks in …


Script runtime API …


Datapane Teams API …


Datapane helper functions to make creating your reports a bit simpler and reduce common tasks …


Datapane User API …


class Markdown (*a, **kw)

Markdown objects store Markdown text that can be displayed as formatted text when viewing your report.

Note: This object is also available as dp.Text, and any strings provided directly to the Report/Group object are converted automatically to Markdown blocks

Tip: You can also insert a dataframe in a Markdown block as a table by using df.to_markdown(), or use dp.Table or dp.DataTable for dedicated dataframe tables.

Args:te text: The markdown formatted text, use triple-quotes, ("""# My Title""") to create multi-line markdown text file: Path to a file containing markdown text name: A unique name for the block to reference when adding text or embedding (optional)


Class variables

var content : str


def format(self, *args: Union[ForwardRef('Group'), ForwardRef('Select'), ForwardRef('DataBlock'), Any], **kwargs: Union[ForwardRef('Group'), ForwardRef('Select'), ForwardRef('DataBlock'), Any]) ‑> Group

Inherited from: Text.format

Format the markdown text template, using the supplied context to insert blocks into {{}} markers in the template …

class Blocks (*a, **kw)

Groups act as a container that hold a list of nested Blocks object, such as Tables, Plots, etc.. - they may even hold Group themselves recursively.

Group are used to provide a grouping for blocks can have layout options applied to them

Note: Group expects a list of Blocks, e.g. a Plot or Table, but also including Select or Groups themselves,

but if a Python object is passed, e.g. a Dataframe, Datapane will attempt to convert it automatically.


Group to add to report
Allows providing the report blocks as a single list
A unique id for the blocks to aid querying (optional)
A label used when displaying the block (optional)
Display the contained blocks, e.g. Plots, using n rows (set to 0 to autofill)
Display the contained blocks, e.g. Plots, using n columns (set to 0 to autofill)

Tip: Group can be passed using either arg parameters or the blocks kwarg, e.g.

dp.Group(plot, table, columns=2) or dp.Group(blocks=[plot, table], columns=2)


Class variables

var blocks : List[Union[GroupSelectDataBlock]]