MoltinMoltin Docs

Connect Overview

Connect is where you organize your data into collections and manage API sources. Open it by clicking the stack_group icon in the navigation rail; its one secondary-nav item is Overview (/connect/overview).

🎬Opening Connect from the navigation rail.Watch
Opening Connect from the navigation rail.

The Connect area exposes a single Overview page in its secondary navigation.

🎬Connect's secondary navigation: Overview.Watch
Connect's secondary navigation: Overview.

The Overview layout

A search box (Search for a collection…) filters your collections.

🎬Search for a collection… filters the collections list.Watch
Search for a collection… filters the collections list.

The orange Create button opens the create menu.

🎬The Create button opens the collection-creation menu.Watch
The Create button opens the collection-creation menu.

A Recent Collections section in the sidebar lists collections you've worked with recently.

🎬The Recent Collections sidebar section.Watch
The Recent Collections sidebar section.

Empty states

On a fresh workspace, the Overview shows helpful empty states. The Collections list reads "No collections found. Create a collection to get started."

🎬The collections empty state on a fresh workspace.Watch
The collections empty state on a fresh workspace.

Recent Collections shows "No recent collections found."

🎬The Recent Collections empty state.Watch
The Recent Collections empty state.

API Sources shows "No API sources found. Create an API source to get started."

🎬The API sources empty state.Watch
The API sources empty state.

Info panels

A right-hand panel surfaces your API Key for authenticating requests to the Moltin API.

🎬The API Key info panel.Watch
The API Key info panel.

A Learn & Explore panel links out to documentation about sources and collections.

🎬The Learn & Explore info panel.Watch
The Learn & Explore info panel.

Creating a collection

Click Create to open the create menu, which offers Create a new collection (Organize your data sources).

🎬The Create dropdown: Create a new collection.Watch
The Create dropdown: Create a new collection.
🎬Press Escape (or click away) to close the dropdown.Watch
Press Escape (or click away) to close the dropdown.

Selecting it opens the Create Collection dialog. You can open and dismiss the dialog without creating anything.

🎬The Create Collection prompt.Watch
The Create Collection prompt.
🎬Opening and closing the Create Collection dialog.Watch
Opening and closing the Create Collection dialog.

What a collection needs

The Create Collection dialog requires three things before it will submit:

  1. NameWhat would you like to call this collection?
  2. Vault Provider — defaults to Use Moltin.
  3. Select Sources — at least one document (Documents tab) or file (Files tab). Submitting with a name only leaves the dialog open and prompts you to select a source.
🎬A name alone isn't enough — you must select at least one source.Watch
A name alone isn't enough — you must select at least one source.

Sources must be published documents

Only published documents appear in the collection's Select Sources picker. Publish a document from the document editor (toggle its status to Published) before it can back a collection.

Creating from a published source document

With a published document available, name the collection, pick the document under Select Sources, and click Create Collection — the dialog closes and the new collection appears in your list.

🎬Creating a collection: name it, select a published document source, and create.Watch
Creating a collection: name it, select a published document source, and create.