File Library

The File Library is your personal storage for documents, images, and other files you want to use with AI. Upload once, use anywhere.

Two Ways to Use Files

PromptBlocks has two ways to share files with AI:

1. Chat Attachments

Quick file sharing in a single message:

• Drag and drop onto the chat
• Files are embedded in that message
• Good for one-time use

2. File Library

Permanent storage you can access anytime:

• Upload to your library once
• Attach to projects
• Access from any chat
• Organize with tags and descriptions

Use chat attachments for quick, one-off shares. Use the File Library when you'll reference a file multiple times or want to attach it to a project.

Chat Attachments vs File Library

Uploading Files

To the File Library

1. Go to File Library from the sidebar
2. Click Upload or drag and drop files
3. Optionally add a description and tags
4. Files are stored in your personal library

To a Chat

1. Drag and drop onto the chat input
2. Or click the attachment button
3. The file is attached to your next message

Supported File Types

Creating Files from Text

You can create text files directly from pasted content:

1. Click "Create File" in the File Library
2. Select the "Paste Text" tab
3. Enter a filename (will be saved as .txt)
4. Paste or type your content
5. Click "Create File"

Use cases:

• Save text snippets for later reference
• Create documentation files from copied content
• Store notes and outlines alongside your other files

Files created from text get automatic AI-generated descriptions, just like uploaded files.

Project integration: When creating a file from a project's Quick Actions panel, the file is automatically attached to that project.

Organizing Files

Tags

File tags use the same shared tag system as prompts and chats:

• Consistent tags: The same tags you use for prompts and chats are available for files
• Unified filtering: Filter files by any tag you've created anywhere in the app
• Easy management: Add or remove tags from the file details modal using the tag selector

Descriptions

Add descriptions to remember what each file contains:

• Why you uploaded it
• What project it's for
• Key contents

Sorting Files

Use the sort dropdown to organize your file list:

• Name A-Z: Alphabetical order
• Name Z-A: Reverse alphabetical order
• Newest: Most recently uploaded first
• Oldest: Oldest files first

Finding Files

The File Library has filters:

• Search — Find by name or description
• Type filter — Show only images, documents, etc.
• Tag filter — Show files with specific tags
• Project filter — Show only files attached to a specific project

Files and Projects

Files work great with projects:

Attaching Files to Projects

1. Open a project
2. Go to Quick Actions → Project Info
3. Upload new files or attach from your library
4. Files appear in the project's file list

Auto-Tagging

Files uploaded from within a project get automatically tagged with project:project-name. This makes it easy to find all files for a project in your File Library.

Viewing Project Associations

In the File Library, file cards display which projects each file is attached to:

• Project names appear as clickable links below the file tags
• Click a project name to navigate directly to that project
• Files can belong to multiple projects

How the AI Uses Project Files

When chatting inside a project, the AI automatically searches your attached files for relevant content:

1. Files are indexed automatically when attached to a project
2. When you send a message, the system finds relevant excerpts from your files
3. Those excerpts are provided to the AI as context for its response

This means you don't need to manually attach files to each message—just attach them to the project once and the AI will reference them when relevant.

Supported for search: Text files (.txt, .md, .csv, .json), PDFs, and Word documents (.docx). Files over 50MB are not indexed.

Automatic re-indexing: When you edit a file's content, it's automatically re-indexed—no manual steps needed.

Managing Files

Preview and Edit

Click any file in the File Library to open it in a modal where you can preview and edit:

Preview formats:

• Text files: View content with syntax highlighting
• Markdown: Rendered with formatting
• PDFs: View pages directly in the modal
• Images: View at full size

Editing capabilities:

• Filename: Rename the file directly in the modal
• Description: Add or update the file description
• Tags: Add or remove tags using the tag selector
• Projects: Manage which projects the file is associated with
• Content: For text files (.txt, .md, .json, etc.), edit content directly and save changes

Download

Click the download button on any file. Downloads use secure, time-limited links.

Delete

Remove files you no longer need. Deleted files are removed from any projects they were attached to.

Storage

The File Library shows your storage usage:

• Total number of files
• Total storage used
• Breakdown by file type

Security

Your files are secure:

• Stored in your personal folder only you can access
• Download links expire after 1 hour
• Files are never shared with other users

Best Practices

1. Name files clearly — Use descriptive names the AI can understand
2. Add descriptions — Help yourself remember what's in each file
3. Use tags consistently — Develop a system (by project, by type, etc.)
4. Attach to projects — Keep reference files with related work
5. Clean up regularly — Delete files you no longer need

Related

• Attach files in chat →
• Use files with projects →