# fiftyone.core.plots.manager Session plot manager. Copyright 2017-2026, Voxel51, Inc.
[voxel51.com](https://voxel51.com/)

**Classes:** | [`PlotManager`](#fiftyone.core.plots.manager.PlotManager)(session) | Class that manages communication between a [`fiftyone.core.session.Session`](fiftyone.core.session.md#fiftyone.core.session.Session) and one or more [`fiftyone.core.plots.base.ResponsivePlot`](fiftyone.core.plots.base.md#fiftyone.core.plots.base.ResponsivePlot) instances. | |----------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| ### *class* fiftyone.core.plots.manager.PlotManager(session) Bases: `object` Class that manages communication between a [`fiftyone.core.session.Session`](fiftyone.core.session.md#fiftyone.core.session.Session) and one or more [`fiftyone.core.plots.base.ResponsivePlot`](fiftyone.core.plots.base.md#fiftyone.core.plots.base.ResponsivePlot) instances. Each plot can be linked to either the view, samples, frames, or labels of a session: - **View links:** When a plot has `link_type == "view"`, then, when the session’s view changes, the plot is updated based on the content of the view - **Sample links:** When points are selected in a plot with `link_type == "samples"`, a view containing the corresponding samples is loaded in the App. Conversely, when the session’s view changes, the corresponding points are selected in the plot - **Frame links:** When points are selected in a plot with `link_type == "frames"`, a view containing the corresponding frames is loaded in the App. Conversely, when the session’s view changes, the corresponding points are selected in the plot - **Label links:** When points are selected in a plot with `link_type == "labels"`, a view containing the corresponding labels is loaded in the App. Conversely, when the session’s view changes, the points in the plot corresponding to all labels in the view are selected in the plot * **Parameters:** **session** – a [`fiftyone.core.session.Session`](fiftyone.core.session.md#fiftyone.core.session.Session) **Methods:** | [`summary`](#fiftyone.core.plots.manager.PlotManager.summary)() | Returns a string summary of this manager. | |-----------------------------------------------------------------------------------------------|--------------------------------------------------------------------| | [`keys`](#fiftyone.core.plots.manager.PlotManager.keys)() | Returns an iterator over the names of plots in this manager. | | [`items`](#fiftyone.core.plots.manager.PlotManager.items)() | Returns an iterator over the `(name, plot)` pairs in this manager. | | [`values`](#fiftyone.core.plots.manager.PlotManager.values)() | Returns an iterator over the plots in this manager. | | [`attach`](#fiftyone.core.plots.manager.PlotManager.attach)(plot[, name, connect, overwrite]) | Attaches a plot to this manager. | | [`remove`](#fiftyone.core.plots.manager.PlotManager.remove)(name) | Removes the plot from this manager. | | [`clear`](#fiftyone.core.plots.manager.PlotManager.clear)() | Removes all plots from this manager. | | [`pop`](#fiftyone.core.plots.manager.PlotManager.pop)(name) | Removes the plot from this manager and returns it. | | [`connect`](#fiftyone.core.plots.manager.PlotManager.connect)() | Connects this manager to its session and all plots. | | [`disconnect`](#fiftyone.core.plots.manager.PlotManager.disconnect)() | Disconnects this manager from its session and all plots. | | [`sync`](#fiftyone.core.plots.manager.PlotManager.sync)() | Syncs all connected plots with the session's current view. | | [`freeze`](#fiftyone.core.plots.manager.PlotManager.freeze)() | Freezes all connected plots, replacing them with static images. | **Attributes:** | [`is_connected`](#fiftyone.core.plots.manager.PlotManager.is_connected) | Whether this manager is currently connected to its plots. | |---------------------------------------------------------------------------------|----------------------------------------------------------------| | [`is_disconnected`](#fiftyone.core.plots.manager.PlotManager.is_disconnected) | Whether this manager is currently disconnected from its plots. | | [`has_view_links`](#fiftyone.core.plots.manager.PlotManager.has_view_links) | Whether this manager has plots linked to views. | | [`has_sample_links`](#fiftyone.core.plots.manager.PlotManager.has_sample_links) | Whether this manager has plots linked to samples. | | [`has_frame_links`](#fiftyone.core.plots.manager.PlotManager.has_frame_links) | Whether this manager has plots linked to frames. | | [`has_label_links`](#fiftyone.core.plots.manager.PlotManager.has_label_links) | Whether this manager has plots linked to labels. | #### summary() Returns a string summary of this manager. * **Returns:** a string summary #### keys() Returns an iterator over the names of plots in this manager. * **Returns:** an iterator over plot names #### items() Returns an iterator over the `(name, plot)` pairs in this manager. * **Returns:** an iterator that emits `(name, ResponsivePlot)` tuples #### values() Returns an iterator over the plots in this manager. * **Returns:** an iterator that emits [`fiftyone.core.plots.base.ResponsivePlot`](fiftyone.core.plots.base.md#fiftyone.core.plots.base.ResponsivePlot) instances #### *property* is_connected Whether this manager is currently connected to its plots. #### *property* is_disconnected Whether this manager is currently disconnected from its plots. #### *property* has_view_links Whether this manager has plots linked to views. #### *property* has_sample_links Whether this manager has plots linked to samples. #### *property* has_frame_links Whether this manager has plots linked to frames. #### *property* has_label_links Whether this manager has plots linked to labels. #### attach(plot, name=None, connect=True, overwrite=True) Attaches a plot to this manager. * **Parameters:** * **plot** – a [`fiftyone.core.plots.base.ResponsivePlot`](fiftyone.core.plots.base.md#fiftyone.core.plots.base.ResponsivePlot) * **name** (*None*) – an optional name for the plot * **connect** (*True*) – whether to immediately connect the plot * **overwrite** (*True*) – whether to overwrite an existing plot of the same name #### remove(name) Removes the plot from this manager. * **Parameters:** **name** – the name of a plot #### clear() Removes all plots from this manager. #### pop(name) Removes the plot from this manager and returns it. * **Parameters:** **name** – the name of a plot * **Returns:** the [`fiftyone.core.plots.base.ResponsivePlot`](fiftyone.core.plots.base.md#fiftyone.core.plots.base.ResponsivePlot) #### connect() Connects this manager to its session and all plots. #### disconnect() Disconnects this manager from its session and all plots. #### sync() Syncs all connected plots with the session’s current view. #### freeze() Freezes all connected plots, replacing them with static images. Only applicable in notebook contexts.