Menu
Browse documentation

Capture a note, link, image, or document

Save an idea quickly to the inbox, add context and tags, and choose a collection when you are ready to give it a home.

Follow the steps

  1. Open Inbox or Library and choose Capture an idea.

  2. Choose Note, Link, or Image or document. A note needs a title; a link also needs a safe external URL; an upload uses a local file.

  3. Add optional notes, comma-separated tags, and a collection, then choose Save idea. New captures go to the inbox until you move them out.

  4. Open the item later to edit its context, add it to a canvas, extract a palette from an uploaded image, or start document extraction.

  5. When automatic smart tags are enabled, a new capture can queue tagging automatically. Successful tags are added to the saved item and can be edited or removed immediately.

What to know

  • The server upload allowlist currently includes JPEG, PNG, WebP, GIF, PDF, plain text, Markdown, DOCX, PPTX, and XLSX MIME types.
  • Uploaded files are stored as file or image assets. Binary uploads use the session-authenticated upload flow; the personal REST capture endpoint accepts an externally hosted image URL instead.
  • A link must use a safe external URL. The API rejects unsupported or unsafe URLs rather than treating them as ordinary text.
  • Smart tagging sends only the item title, up to 8,000 characters of saved text, current tags and, for a stored image, a sanitized 512-pixel thumbnail. It does not scan the rest of the library, fetch a remote source URL or run routine OCR.

Troubleshooting

  • If a file is rejected, check both its MIME type and size. The API accepts files from 1 byte through 20 MB.
  • If a link will not save, include an https or other accepted external URL and remove local-file or unsupported URL schemes.
  • If the item is not in Library, open Inbox or clear the collection/type/search filters. New captures default to inbox=true.

Need a hand with the next step?

Browse the other guides or send us the details of where you got stuck.

Contact Canvas Perch