Skip to contents

Vitessce is a visual integration tool for exploration of spatial single-cell experiments. To learn more about the features of Vitessce, please visit our core docs.

Getting Started

The vitessceR package includes:

  • Vitessce as an htmlwidget

  • Use Vitessce directly within RStudio as an interactive widget

  • View config API

  • Create and edit Vitessce configurations using R6 object-oriented syntax

  • Data preparation

  • Use our data conversion wrapper classes to process data stored in common single-cell file types including Seurat objects.


Installation requires R 4.0.0 or greater.



The simplest way to instantiate a Vitessce widget is to create a view config based on a single-cell dataset object and call the widget function on the view config instance:


# Create Vitessce view config
vc <- VitessceConfig$new("My config")
dataset <- vc$add_dataset("My dataset")
scatterplot <- vc$add_view(dataset, Component$SCATTERPLOT, mapping = "pca")
status <- vc$add_view(dataset, Component$STATUS)
cell_sets <- vc$add_view(dataset, Component$CELL_SETS)
vc$layout(hconcat(scatterplot, vconcat(status, cell_sets)))

# Render the Vitessce widget

For a full example, visit the Usage with JSON page.

To customize the view config passed into the widget (or to define a view config manually), please see the documentation for the VitessceConfig class.