Skip to content

How to Connect Your Data Library

Concept

1. Open the Library Menu

On the Data Exploration page (Datasets, Collections, or Bookmarks), click the library button in the top-right area of the top bar. The button shows the currently active library name (default: CartoStore).

2. Add a New Library

  1. In the library dropdown, click Add Library at the bottom.
  2. In the dialog, fill in:
  3. Library Name: A short, recognizable label (e.g., "My Lab", "Tumor Atlas").
  4. Library metadata root URL: The URL pointing to the folder that contains datasets.parquet.
  5. Click Add. CartoScope validates the connection before saving.

Accepted URL formats

AWS S3 URI 

1
s3://my-bucket/project/metadb

HTTPS URL 

1
https://my-bucket.s3.amazonaws.com/project/metadb

CORS requirement

The server hosting your library must allow CORS requests from CartoScope's domain. For AWS S3, configure a CORS policy on the bucket. See How to Host on AWS S3 for details.

3. Switch Between Libraries

Click the library button and select any library from the list. The Datasets view reloads with the selected library's catalog.

The active library is remembered across page navigations within the session.

4. Edit or Delete a Library

In the library dropdown, hover over a custom library entry to reveal the Edit (pencil) and Delete (trash) icons.

  • Edit: Update the name or URL, then click Save. CartoScope re-validates the connection.
  • Delete: Removes the library from the list. CartoStore becomes the active library if the deleted library was selected.

Note

CartoStore (the default) cannot be edited or deleted.

FAQ