Attachments

Attachments let you embed files in your workspace pages — maps of the Verdant Undercity, PDFs of research notes, images of Thornwall Keep’s floor plan. Files are stored locally alongside your workspace database and can be referenced from any page.

Upload an attachment

Attachments can be added to a page in two ways:

• Drag and drop a file onto the page editor
• Paste an image from your clipboard directly into the editor

The file is processed, stored, and inserted into the page. You don’t need to manage file paths or folders — Inklings handles storage automatically.

Supported file types

The attachment system accepts these file types:

Category	Extensions
Images	PNG, JPG/JPEG, GIF, WebP, SVG
Documents	PDF, DOCX, DOC
Data	CSV

Files with unsupported extensions are rejected at upload time with a clear error message. No file is written to disk when a validation error occurs.

File size limits

Limit	Value
Per file	10 MB
Maximum paste/bytes upload	16 MB

Files exceeding these limits are rejected before storage. The error message indicates which limit was exceeded.

Content deduplication

Inklings uses SHA-256 content hashing to deduplicate attachments. If you upload the same file twice — even with different filenames — only one copy is stored on disk. Both uploads return the same attachment ID. This keeps your workspace storage efficient as your world grows.

View and manage attachments

Open the Attachments panel from the sidebar footer to see all files uploaded to the workspace. The panel lists every attachment with its filename, file type, size, and upload date.

Attachments can also be filtered by page — only files referenced by a specific page appear when you view that page’s attachment list.

Delete an attachment

To delete an attachment:

1. Open the Attachments panel or navigate to the attachment in question.
2. Select the attachment and choose Delete.

Deletion removes both the metadata record and the on-disk file, including any cached image variants. If the attachment is still referenced by a page, the delete is blocked — remove the reference from the page first, then delete the attachment.

Caution

Attachment deletion is permanent. There is no trash recovery for attachments. Make sure no pages reference the file before deleting.

Attachment metadata

Every attachment includes:

Field	Description
ID	Unique UUID identifier
Filename	Original filename at upload
Extension	File type extension
Content type	MIME type
Size	File size in bytes
Content hash	SHA-256 hex digest (64 characters)
Created at	Upload timestamp
Sync status	local_only until cloud sync is configured

Image processing

Image attachments are stored in their original format and processed into display and thumbnail variants for rendering in the editor. These cached variants are cleaned up automatically when the original attachment is deleted.

Magic-byte validation applies to image uploads — if an uploaded file claims to be a PNG but contains JPEG data, the upload is rejected.

See Also

• Image Blocks — Embed images as blocks in your page content
• Create and Edit Pages — Page creation basics
• Settings Reference — Workspace storage settings