Attachments

Kitted lets you attach documents and files directly to stock items, assemblies, suppliers, production orders, and purchase orders. Attachments are stored on your machine alongside the rest of your data and are included in backups automatically.

Where Attachments Appear

An Attachments card is shown on the detail page of each supported record:

Uploading a File

Open the detail page for a supplier, production order, or purchase order. In the Attachments card:

• Click Attach file to open a file picker and select a file from your machine, or
• Drag and drop a file from your file manager directly onto the card (the card highlights in blue when a file is being dragged over it).

The file is uploaded immediately. Once complete it appears in the list below the card header.

File Type and Size Limits

Files outside these types are rejected with an error message. There is no limit on the number of attachments per record.

Viewing and Downloading

Each attachment in the list shows:

• A file type icon
• The original filename
• The file size and upload date

To open a file: click the filename. The file opens in a new browser tab (inline preview for PDFs and images; other types may be handled by the browser’s default behaviour).

To download a file: click the download icon (↓) on the right of the row. The file is saved to your downloads folder with its original name.

Tags

Each attachment can have one or more tags to help you categorise and find documents. Tags are free-form labels you define yourself - for example spec-sheet, invoice, cert, or safety-data.

Adding or editing tags

Click the tag icon (or the tag chip area) on any attachment row to open the Edit document tags modal:

• The current tags for that attachment are shown as removable chips at the top.
• Type in the search box to filter existing tags or create a new one.
• Select a suggestion from the dropdown (use the mouse or Arrow keys to navigate, Enter or click to select).
• If no existing tag matches your input, a Create ”…” option appears - click it to create and apply the new tag immediately.
• Click the × on any chip to remove a tag.
• Click Save to apply changes. Click Cancel or press Escape to discard.

Tags are shared across all attachments - a tag you create on one record is available on any other.

Deleting an Attachment

Click the trash icon on the right of the row and confirm the prompt. The file is permanently removed from disk and cannot be recovered.

Storage

Attachments are stored in a dedicated folder on your machine, separate from the database file. The default path is inside your data directory:

<data directory>/attachments/

You can move the attachments folder to a different location independently of the database - go to Settings → Data → Attachments folder and enter a new path. A restart is required for the change to take effect; files must be manually copied to the new location.

Backups

Attachments are included in the backup ZIP created by Kitted’s built-in backup feature. The ZIP contains an attachments/ folder alongside kitted.db. If you restore from a backup, copy this folder back into your data directory as well. See Backup and Restore for full details.