class napari.components.LayerList(data=())[source]


List-like layer collection with built-in reordering and callback hooks.


data (iterable) – Iterable of napari.layer.Layer




S.append(value) – append value to the end of the sequence

clear()None remove all items from S

Return a shallow copy of the list.

Return type


count(value)integer return number of occurrences of value

S.extend(iterable) – extend sequence by appending elements from the iterable

property extent

Extent of layers in data and world coordinates.

Return type


index(value, start=0, stop=None)

Return first index of value.

  • value (Any) – A value to lookup. If type(value) is in the lookups functions provided for this class, then values in the list will be searched using the corresponding lookup converter function.

  • start (int, optional) – The starting index to search, by default 0

  • stop (int, optional) – The ending index to search, by default None


The index of the value

Return type



ValueError – If the value is not present

insert(index, value)[source]

Insert value before index.

move(src_index, dest_index=0)

Insert object at src_index before dest_index.

Both indices refer to the list prior to any object removal (pre-move space).

Return type


move_multiple(sources, dest_index=0)

Move a batch of indices, to a single destination.

Note, if the dest_index is higher than any of the source indices, then the resulting position of the moved objects after the move operation is complete will be lower than dest_index.

  • sources (Sequence[int or slice]) – A sequence of indices

  • dest_index (int, optional) – The destination index. All sources will be inserted before this index (in pre-move space), by default 0… which has the effect of “bringing to front” everything in sources, or acting as a “reorder” method if sources contains all indices.


The number of successful move operations completed.

Return type



TypeError – If the destination index is a slice, or any of the source indices are not int or slice.

move_selected(index, insert)[source]

Reorder list by moving the item at index and inserting it at the insert index. If additional items are selected these will get inserted at the insert index too. This allows for rearranging the list based on dragging and dropping a selection of items, where index is the index of the primary item being dragged, and insert is the index of the drop location, and the selection indicates if multiple items are being dragged. If the moved layer is not selected select it.

  • index (int) – Index of primary item to be moved

  • insert (int) – Index that item(s) will be inserted at

property ndim

Maximum dimensionality of layers.

Defaults to 2 if no data is present.



Return type


pop([index])item remove and return item at index (default last).

Raise IndexError if list is empty or index is out of range.


S.remove(value) – remove first occurrence of value. Raise ValueError if the value is not present.


Removes selected items from list.


Reverse list IN PLACE.

Return type


save(path, *, selected=False, plugin=None)[source]

Save all or only selected layers to a path using writer plugins.

If plugin is not provided and only one layer is targeted, then we directly call the corresponding``napari_write_<layer_type>`` hook (see single layer writer hookspecs) which will loop through implementations and stop when the first one returns a non-None result. The order in which implementations are called can be changed with the Plugin sorter in the GUI or with the corresponding hook’s bring_to_front() method.

If plugin is not provided and multiple layers are targeted, then we call napari_get_writer() which loops through plugins to find the first one that knows how to handle the combination of layers and is able to write the file. If no plugins offer napari_get_writer() for that combination of layers then the default napari_get_writer() will create a folder and call napari_write_<layer_type> for each layer using the variable to modify the path such that the layers are written to unique files in the folder.

If plugin is provided and a single layer is targeted, then we call the napari_write_<layer_type> for that plugin, and if it fails we error.

If plugin is provided and multiple layers are targeted, then we call we call napari_get_writer() for that plugin, and if it doesn’t return a WriterFunction we error, otherwise we call it and if that fails if it we error.

  • path (str) – A filepath, directory, or URL to open. Extensions may be used to specify output format (provided a plugin is available for the requested format).

  • selected (bool) – Optional flag to only save selected layers. False by default.

  • plugin (str, optional) – Name of the plugin to use for saving. If None then all plugins corresponding to appropriate hook specification will be looped through to find the first one that can save the data.


File paths of any files that were written.

Return type

list of str


Selects all layers.


Selects next item from list.


Selects previous item from list.

property selected

List of selected layers.


Toggle visibility of selected layers


Unselects all layers expect any specified in ignore.


ignore (Layer | None) – Layer that should not be unselected if specified.