Description, files and images
The description editor
A rich-text box with a small toolbar: bold, italic, underline, strikethrough, headings, numbered and bulleted lists, links, and a button that strips formatting back out.
That is deliberately a short list. A description is meant to be read quickly by somebody standing on a site, not laid out like a report.
Pasting works properly. Text pasted from Word, from an email or from a browser is cleaned on the way in: you keep the words, the paragraphs, the headings and the lists, and you leave behind the fonts, colours and invisible styling that would otherwise make the issue look like a ransom note.
The description has its own green Save button under the editor. Unlike the other fields, it does not save by itself. Close the panel without clicking Save and the text is gone.
Attaching files
Under the description there is a drop area: drag files onto it, or click click to select files. Several at once is fine, and there is a progress bar for large ones.
Where they end up depends on when you attach them.
On an issue that already exists, files go into the comments below - the app tells you so when the upload finishes. This is the normal case, and it is usually what you want: an attachment arrives with a timestamp and a person against it, in sequence with everything else that has been said.
On a brand new issue that you have not saved yet, the files are attached to the issue itself when you save.
You can also attach a file to a specific comment as you write it, which is the neatest option when the file is evidence for a particular point. See Comments and mentions.
Images
An image attached to an issue shows as a thumbnail on the card in the board and in the list, and full size when you click it.
The thumbnail is the newest image on the issue, so attaching a photo of the finished work replaces the photo of the problem in that little preview. The old one is still there in the comments.
Images that arrive from other BIM tools
When an issue comes in through a BCF import, the screenshot travels with it as part of a viewpoint - a saved camera position plus a picture, taken in whatever software raised the issue.
Those show as the thumbnail too. You do not have to do anything, but it is worth knowing the distinction: a viewpoint image carries a camera position that means something when the file goes back to a model viewer, and a photograph you attach does not.
Both are included when you export, as long as Viewpoint images is ticked.
Two habits worth having
Write a line of text even when the picture says it all. An image is invisible to the search box, to an AI assistant, to a filter, and to somebody on a phone with a slow connection. One sentence - "duct clashes with beam, grid C4" - makes the issue findable by everything.
Attach the file to the comment it belongs to. Twelve photographs on one issue with no words between them is an archive nobody can read. Twelve comments with a photograph each is a history.
Deleting an attachment
Attachments can be removed individually. Removing one does not remove the comment it came with.
Deleting the whole issue takes every attachment with it, permanently - see Who may do what.