Document Icons

From Document Icons - Icons and Images - macOS - Human Interface Guidelines - Apple Developer

If you don’t supply a document icon for a file type you support, macOS 11 creates one for you by compositing your app icon and the file’s extension onto the canvas.

Although I’m not sure what does the last part of the quotation (“onto the canvas”) mean, after removing the icon from the filetype-set of an app of mine (but keeping all the old data), I saved a doc. But the doc showed the same icon as before.
Then I created a new filetype-set with a new name and no icon, and I increased the non release version number. The saved file showed a black icon.

So I’d like to know if there are declares available to achieve this goal.

Or am I missing something obvious? It wouldn’t be the first time…


I can tell you that “onto the canvas” is probably supposed to be something about being drawn onto the blank icon template. Here’s a screenshot of a generated VersionTracker document. There are no document icons for VersionTracker, macOS generated this icon.

You may be experiencing icon caching issues. This terminal command may help you resolve that.

That’s what I thought but was reluctant to use the terminal command because in the past I had had some problems with clearing the caches. Anyway, a restart showed the app-icon into the saved document file. Thank you.

1 Like