> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/readme.md).

# Welcome

Shade is AI-powered media storage for creative teams. Store, search, review, and share your media from the browser, or mount your drives on your desktop with ShadeFS.

<button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">What are you trying to do?</button>

<a href="/getting-started/quickstart.md" class="button primary">Get the App</a><a href="/getting-started/learn-80-of-shade-in-2-minutes.md" class="button secondary" data-icon="bolt">Learn Shade in 2 minutes</a>

<h3 align="center">How do you use Shade?</h3>

<p align="center">Pick the path that fits your role. Most teams have all three.</p>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><h4><i class="fa-clapperboard">:clapperboard:</i></h4></td><td><h4>Editors and creatives</h4></td><td>Mount your drives and edit straight from the cloud in your NLE.</td><td><a data-mention href="/shadefs/introduction-to-shadefs.md">Introduction to ShadeFS</a></td><td><a data-mention href="/shadefs/pinning-files-offline.md">Pinning Files Offline</a></td><td><a href="https://academy.shade.inc/guides/how-to-use-shade-with-adobe-premiere-pro">Shade with Premiere Pro</a></td></tr><tr><td><h4><i class="fa-users">:users:</i></h4></td><td><h4>Producers and teams</h4></td><td>Share work, collect feedback, and deliver to clients.</td><td><a data-mention href="/sharing-and-collaboration/sharing-folders-and-files.md">Sharing Folders and Files</a></td><td><a data-mention href="/sharing-and-collaboration/published-links.md">Published Links</a></td><td><a data-mention href="/sharing-and-collaboration/commenting-on-assets.md">Commenting on Assets</a></td></tr><tr><td><h4><i class="fa-shield-halved">:shield-halved:</i></h4></td><td><h4>Admins and IT</h4></td><td>Set up workspaces, control access, and roll Shade out securely.</td><td><a data-mention href="/workspaces-and-drives/setting-up-workspaces-and-drives.md">Setting Up Workspaces and Drives</a></td><td><a data-mention href="/sharing-and-collaboration/permission-management-overview.md">Permission Management Overview</a></td><td><a data-mention href="/enterprise/enterprise-security-and-sso.md">Enterprise Security and SSO</a></td></tr></tbody></table>

***

<h3 align="center">From upload to delivery</h3>

<p align="center">Follow it end to end, or jump to the step you're on.</p>

<table data-card-wrap="false" data-view="cards"><thead><tr><th><select><option value="sUpLd1aB2cD3" label="UPLOAD" color="blue"></option><option value="sOrg4eF5gH6i" label="ORGANIZE" color="blue"></option><option value="sFnd7jK8lM9n" label="FIND" color="blue"></option><option value="sShr0pQ1rS2t" label="SHARE" color="blue"></option></select></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><span data-option="sUpLd1aB2cD3">UPLOAD</span></td><td><h4>Get your media in</h4></td><td>Upload from your desktop, migrate in bulk, or connect your own storage.</td><td><a data-mention href="/getting-started/start-uploading-assets.md">Start Uploading Assets</a></td><td><a href="https://academy.shade.inc/guides/mass-migrating-data-to-shade-via-rclone">Mass migrating with Rclone</a></td><td><a data-mention href="/byos/bring-your-own-s3-storage.md">Bring Your Own S3 Storage</a></td></tr><tr><td><span data-option="sOrg4eF5gH6i">ORGANIZE</span></td><td><h4>Structure your library</h4></td><td>Lay out workspaces and drives, and keep folders and metadata consistent.</td><td><a data-mention href="/getting-started/publish-your-docs.md">Understand the Structure</a></td><td><a data-mention href="/workspaces-and-drives/folder-templates.md">Folder Templates</a></td><td><a data-mention href="/ai-tools/custom-and-automated-metadata.md">Metadata and Custom Fields</a></td></tr><tr><td><span data-option="sFnd7jK8lM9n">FIND</span></td><td><h4>Find anything</h4></td><td>Search by what's in your footage, not just file names.</td><td><a data-mention href="/assets/search-and-discovery-transcription-and-precision-filtering.md">Search and Discovery (Transcription &amp; Precision Filtering)</a></td><td><a data-mention href="/assets/precision-filtering.md">Precision Filtering</a></td><td><a data-mention href="/ai-tools/ai-search-best-practices.md">AI Search Best Practices</a></td></tr><tr><td><span data-option="sShr0pQ1rS2t">SHARE</span></td><td><h4>Review and deliver</h4></td><td>Bring in collaborators and clients without giving away your whole drive.</td><td><a data-mention href="/sharing-and-collaboration/inviting-external-collaborators.md">Inviting External Collaborators</a></td><td><a data-mention href="/sharing-and-collaboration/creating-asset-collections.md">Creating Asset Collections</a></td><td><a data-mention href="/sharing-and-collaboration/working-with-clients-best-practices.md">Working with Clients: Best Practices</a></td></tr></tbody></table>

***

<h3 align="center">AI built in</h3>

<p align="center">Shade indexes your media so you, your team, and your AI tools can work with it.</p>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-sparkles">:sparkles:</i></h4></td><td><h4>The Shade MCP</h4></td><td>Connect Claude, ChatGPT, Cursor, or VS Code to your drives.</td><td><a href="/ai-tools/the-shade-mcp.md">The Shade MCP</a></td></tr><tr><td><h4><i class="fa-wand-magic-sparkles">:wand-magic-sparkles:</i></h4></td><td><h4>AI metadata</h4></td><td>Fill custom fields automatically from what's in your images and videos.</td><td><a href="/ai-tools/custom-and-automated-metadata.md">Metadata and Custom Fields</a></td></tr><tr><td><h4><i class="fa-face-viewfinder">:face-viewfinder:</i></h4></td><td><h4>Facial Recognition</h4></td><td>Find every shot of a person across your library.</td><td><a href="/ai-tools/facial-recognition.md">Facial Recognition</a></td></tr><tr><td><h4><i class="fa-diagram-project">:diagram-project:</i></h4></td><td><h4>Automations</h4></td><td>Run workflows when files are uploaded, commented on, added to collections, or their metadata changes.</td><td><a href="/automations-and-custom-objects/automations.md">Automations</a></td></tr></tbody></table>

***

<h3 align="center">Keep going</h3>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-book-open">:book-open:</i></h4></td><td><h4>Guides</h4></td><td>Step-by-step setups for Premiere Pro, Resolve, Avid, and Final Cut Pro.</td><td><a href="https://academy.shade.inc/guides">https://academy.shade.inc/guides</a></td></tr><tr><td><h4><i class="fa-code">:code:</i></h4></td><td><h4>Developers</h4></td><td>Build on Shade with the REST API, webhooks, S3 API, and MCP server.</td><td><a href="https://academy.shade.inc/developers">https://academy.shade.inc/developers</a></td></tr><tr><td><h4><i class="fa-life-ring">:life-ring:</i></h4></td><td><h4>Help Center</h4></td><td>Answers to common questions about billing, drives, and troubleshooting.</td><td><a href="https://academy.shade.inc/help-center">https://academy.shade.inc/help-center</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.