Workspaces and Collections
Group requests into workspaces, collections and folders, and keep them in files you can share.
Overview
A workspace holds a set of related collections, along with their environments, variables, authentication, certificates and cookies. Each window shows one workspace, and you can switch workspaces or open several side by side.
Within a workspace, collections group requests, and folders group them further. Collections and folders can carry their own variables, authentication, scripts and settings, which every request inside them inherits.
A workspace is stored as a folder of JSON documents, one per request, folder, collection and environment. Relay keeps that folder for you, or you can keep it anywhere you choose, such as inside a Git repository, and share it with your team.
Topics
Workspaces
- Understanding workspaces: Learn how workspaces, collections, folders and drafts fit together.
- Creating and managing workspaces: Create, rename, switch between and delete workspaces.
Collections and folders
- Organizing requests into collections: Group requests into collections and folders, and move, copy and style them.
- Configuring collections and folders: Give a collection or folder variables, authentication, scripts and settings that its requests inherit.
Storage and sharing
- Storing a workspace in a folder: Keep a workspace as files in a folder you choose and share it with Git.
- Resolving workspace file issues: Fix a workspace that's read-only or can't be found because of problems with its files.
See Also
- Managing environments: Switch between sets of variables for development, staging and production.
- Workspace file format: The folders and JSON documents that store a workspace.