### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- matplotlib.pyplot »

# matplotlib.pyplot.table

`matplotlib.pyplot.``table`(**kwargs)

  Add a table to the current axes.

  Call signature:

      table(cellText=None, cellColours=None,
            cellLoc='right', colWidths=None,
            rowLabels=None, rowColours=None, rowLoc='left',
            colLabels=None, colColours=None, colLoc='center',
            loc='bottom', bbox=None):

  Returns a `matplotlib.table.Table` instance. Either `cellText` or `cellColours` must be provided. For finer grained control over tables, use the `Table` class and add it to the axes with `add_table()`.

  Thanks to John Gill for providing the class and table.

  kwargs control the `Table` properties:

  > Property | Description
  > --- | ---
  > `agg_filter` | unknown
  > `alpha` | float (0.0 transparent through 1.0 opaque)
  > `animated` | [True | False]
  > `axes` | an `Axes` instance
  > `clip_box` | a `matplotlib.transforms.Bbox` instance
  > `clip_on` | [True | False]
  > `clip_path` | [ (`Path`, `Transform`) | `Patch` | None ]
  > `contains` | a callable function
  > `figure` | a `matplotlib.figure.Figure` instance
  > `fontsize` | a float in points
  > `gid` | an id string
  > `label` | string or anything printable with ‘%s’ conversion.
  > `path_effects` | unknown
  > `picker` | [None|float|boolean|callable]
  > `rasterized` | [True | False | None]
  > `sketch_params` | unknown
  > `snap` | unknown
  > `transform` | `Transform` instance
  > `url` | a url string
  > `visible` | [True | False]
  > `zorder` | any number