> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.new/llms.txt
> Use this file to discover all available pages before exploring further.

# File uploads

> Upload files once to a Rocket.new project and every task gets access instantly.

export const LlmsDirective = () => <blockquote className="llms-directive">
    For the complete documentation index, see <a href="/llms.txt">llms.txt</a>.
    For a lightweight markdown version of this page, append .md to the URL.
  </blockquote>;

<LlmsDirective />

Upload your reference files to a project once and they become persistent context for every task inside it. Company overview, financial model, brand guidelines, research data. Whatever your work depends on, it is available from the first message in every task.

<Info>
  **Project files vs task files:** Files uploaded directly inside a task are scoped to that conversation only. Files uploaded at the project level are persistent and available to every task in the project automatically, without being re-uploaded or re-explained.
</Info>

## What to upload

Upload anything that provides lasting context for your work on this initiative. The best project files are things you'd otherwise paste or re-explain in every task.

| File type       | Examples                                                       |
| :-------------- | :------------------------------------------------------------- |
| Company context | Company deck, one-pager, mission/strategy doc                  |
| Financial data  | P\&L, financial model, cap table (`.xlsx`, `.csv`)             |
| Research        | Market reports, competitor teardowns, user interviews (`.pdf`) |
| Brand assets    | Brand guidelines, logo usage, design system                    |
| Product specs   | PRD, feature specs, user stories (`.pdf`, `.md`)               |
| Reference data  | Pricing data, industry benchmarks, customer data exports       |

<Note>
  You don't need to upload everything upfront. Start with the files you'd reach for most often, and add more as the project evolves.
</Note>

## Upload files to a project

<Steps>
  <Step title="Open your project">
    Click **Projects** in the sidebar, then click your project.

    <Frame caption="Click Projects in the sidebar, then open your project">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/PzBM_J-yZNIHHGC0/images/getting-started/project/manage/create-projects-light.webp?fit=max&auto=format&n=PzBM_J-yZNIHHGC0&q=85&s=493518181b901e7a4ed98be7aa89a0e7" alt="Sidebar with Projects highlighted and a project card visible." className="theme-image light-image" width="1380" height="762" data-path="images/getting-started/project/manage/create-projects-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/PzBM_J-yZNIHHGC0/images/getting-started/project/manage/create-projects-dark.webp?fit=max&auto=format&n=PzBM_J-yZNIHHGC0&q=85&s=e397901ddfe1bb5a8f2f280056932320" alt="Sidebar with Projects highlighted and a project card visible." className="theme-image dark-image" width="1380" height="762" data-path="images/getting-started/project/manage/create-projects-dark.webp" />
    </Frame>
  </Step>

  <Step title="Open the Context tab">
    Inside your project, click the **Context** tab on the right panel. You'll see connectors for My Device, Google Drive, and Notion.

    <Frame caption="Context tab with upload options">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/project-context-light.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=df32e628cf682edbf80b65436ffdc1a3" alt="Project page showing the Context tab with My Device, Google Drive, and Notion options." className="theme-image light-image" width="1816" height="804" data-path="images/getting-started/project/context/file-uploads/web-browser/project-context-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/project-context-dark.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=713c652fb94c09ade43d3b6f7d16bc75" alt="Project page showing the Context tab with My Device, Google Drive, and Notion options." className="theme-image dark-image" width="1816" height="804" data-path="images/getting-started/project/context/file-uploads/web-browser/project-context-dark.webp" />
    </Frame>
  </Step>

  <Step title="Click My Device">
    Click **My Device** to open a file picker. Select the files you want to upload. You can select multiple at once.

    <Frame caption="Click My Device to upload from your computer">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/from-device-light.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=1dfb11cfed1ca14056f7f63ef2dfc174" alt="Context panel with My Device highlighted." className="theme-image light-image" width="2484" height="1036" data-path="images/getting-started/project/context/file-uploads/web-browser/from-device-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/from-device-dark.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=a6f6755163f1ccdd36daef92fb207eea" alt="Context panel with My Device highlighted." className="theme-image dark-image" width="2484" height="1036" data-path="images/getting-started/project/context/file-uploads/web-browser/from-device-dark.webp" />
    </Frame>
  </Step>

  <Step title="Confirm upload">
    Uploaded files appear in the **Files** section of the Context tab. They are immediately available to every task in the project.

    <Frame caption="File visible in the Context panel after upload">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/file-uploaded-light.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=af39039e380845a516cf73094a7c4663" alt="Context panel showing an uploaded PDF in the Files section." className="theme-image light-image" width="2460" height="1050" data-path="images/getting-started/project/context/file-uploads/web-browser/file-uploaded-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/ycIZz3MwlUZ9wn5n/images/getting-started/project/context/file-uploads/web-browser/file-uploaded-dark.webp?fit=max&auto=format&n=ycIZz3MwlUZ9wn5n&q=85&s=01fdbda25cf8d83824c451d1c6f5803d" alt="Context panel showing an uploaded PDF in the Files section." className="theme-image dark-image" width="2502" height="1014" data-path="images/getting-started/project/context/file-uploads/web-browser/file-uploaded-dark.webp" />
    </Frame>
  </Step>
</Steps>

<Check>
  **Success check:** Uploaded files appear in the Files section of the Context tab and can be referenced from any task in the project.
</Check>

## Supported file types

Rocket natively understands five file formats. Each format is parsed for its structure, relationships, and meaning, not treated as a plain text dump.

| File type                            | What Rocket understands                                                                       |
| :----------------------------------- | :-------------------------------------------------------------------------------------------- |
| **Markdown** (`.md`)                 | Headings, sections, code blocks, tables, and links                                            |
| **PDF** (`.pdf`)                     | Full text extraction, document structure, headings, tables, images, and page layout           |
| **Excel** (`.xlsx`)                  | Multi-sheet workbooks, formulas, cross-sheet dependencies, charts, merged cells, and comments |
| **CSV** (`.csv`)                     | Column structure, data types, and row relationships                                           |
| **Images** (`.jpg`, `.jpeg`, `.png`) | Visual content, embedded text, diagrams, and UI layouts                                       |

<Note>
  Google Drive files (Google Docs, Google Sheets) and Notion pages can be connected as live sources via [connected services](/getting-started/project/context/connected-services).
</Note>

## File limits

Projects support up to **5 context sources** at a time. This limit counts across all source types: uploaded files, Google Drive links, and Notion pages combined. If you need to add a new source, remove an existing one first.

## How tasks use shared files

Every task in the project can draw on the shared files automatically. You do not need to re-upload or re-reference them. For the most precise results, mention the file by name in your prompt: "Using the brand guidelines PDF, build a landing page that matches our visual identity."

## Organize files

As your project grows, keeping files organized helps both you and Rocket find what's needed.

<AccordionGroup>
  <Accordion title="Use descriptive file names">
    Name files clearly: `brand-guidelines-v2.pdf` is better than `document.pdf`. Descriptive names help Rocket match files to task context and make it easier for collaborators to find what they need.
  </Accordion>

  <Accordion title="Remove outdated files">
    If a file has been superseded, remove the old version to avoid confusion. Rocket may reference outdated files if they're still present in the project.
  </Accordion>

  <Accordion title="Upload early in the project lifecycle">
    Add foundational files such as brand guides, product specs, and research data when you first create the project. This ensures every task from the start has access to the right context.
  </Accordion>

  <Accordion title="Keep files focused">
    Upload files that are relevant to the project's scope. A project about "Q3 Product Launch" only needs the product brief and brand assets, not the full employee handbook.
  </Accordion>
</AccordionGroup>

## Delete shared files

To remove a file from a project:

<Steps>
  <Step title="Open the Context tab">
    Open the **Context** tab in the project's right panel.
  </Step>

  <Step title="Hover over the file">
    Hover over the file you want to remove.
  </Step>

  <Step title="Click the X button">
    Click the **X** button that appears on the file.
  </Step>
</Steps>

<Warning>
  Deleting a shared file removes it from the project permanently. Tasks that previously referenced the file won't lose their existing outputs, but future tasks won't have access to that file's content.
</Warning>

## What's next?

<CardGroup cols={2}>
  <Card title="Connect services" icon="plug" href="/getting-started/project/context/connected-services">
    Link Notion and Google Drive for live external context.
  </Card>

  <Card title="Context flow" icon="arrows-repeat" href="/getting-started/project/context/overview">
    See how files and task outputs create shared context across your project.
  </Card>

  <Card title="Projects overview" icon="folder-open" href="/getting-started/project/overview">
    Start a new project and upload your first files.
  </Card>

  <Card title="Build from an attachment" icon="paperclip" href="/build/create/from-an-attachment">
    Use uploaded files as a starting point for a Build task.
  </Card>
</CardGroup>
