module-element-icons

Set the icon directly on the stereotype definition as a type/source pair: a FontAwesome type takes an icon name like "cogs", while a UrlImagePath type takes a base64 data URI. Use displayIcon to control whether the badge renders, and displayIconFunction only for genuinely conditional display.

Set the Icon property on the Settings stereotype carried by the Element Settings or Core Type node. Use the static Icon property unless the icon genuinely varies per element, in which case Icon Function returns an icon per element and falls back to the default when it returns null.

module-element-icons sets icons on stereotypes and element types you define in a designer, while module-svg-icon sets the module's own package icon shown in the module registry. The package icon lives in the module's .application.config as a root-level icon/iconType pair, which is a different file and mechanism.

Blank icons usually result from a corrupted base64 payload caused by reading, echoing, or copying the encoded string by hand. Compute the base64 with a shell script and apply it via run_designer_script using includedScriptPaths so the payload never passes through manual transcription.

Use Icon Function only when the icon genuinely varies per element based on its own state, since the function is re-evaluated as the model changes and is harder to reason about. Returning null from the function falls back to the default icon by design.