When a Lucide icon does not appear as expected, first check the selected mode, the icon name, and the exact code. Most problems can be isolated without changing the rest of the page.
The icon code remains visible
Confirm that a Lucide stack exists on the same page and that Use As is set to Code Loader. Preview the page in Stacks App, then check the complete syntax. A basic code should look like ((lucide heart)), including both pairs of parentheses.
The icon does not appear
Open Show Icon Catalog and search for the exact icon name. Copy the name from the catalog instead of guessing. If an expected icon or alias is still missing, install the current Lucide update through the built-in updater in Stacks App and preview again.
Lucide serves SVG assets locally and does not require an external icon CDN. A blocked CDN connection is therefore not part of the normal loading path.
Inline settings do not work
Open Show Code Helper, choose the icon and settings, and copy the generated Ready Code. Compare it with the handwritten code and look for missing quotes, misspelled setting names, or unsupported values. Generated code contains the selected icon together with its active settings and omits unchanged defaults.
Hover or link behavior is missing
Confirm that Make Icon a Link is enabled when the icon should be clickable. Check the link destination and set a distinct hover color if a visual hover state is needed. Test the icon with both pointer and keyboard navigation.
The icon sits too high or low
Use Nudge Y for a small vertical adjustment. Check the actual font, font size, and line height before using a large offset. For custom list bullets, adjust Bullet Gap and test items that wrap to a second line.
Use the Decorative setting correctly
Keep Decorative enabled when the icon repeats information already provided by nearby text. If the icon communicates information or is the only content in a button or link, do not rely on the icon alone. Provide a clear visible label or an accessible name on the surrounding control.
Do not rely on color alone
Status icons for success, warning, error, or information should be accompanied by text. Keep sufficient contrast for normal and hover colors, and verify that links remain understandable when color is not perceived.
Before contacting support
Record the Lucide version, Stacks App version, macOS version, selected mode, icon name, and the exact inline code if one is involved. Include a focused screenshot and explain what you expected. Send the request to support@stackswork.com and follow What to include in a support request.
Related guides
See Getting started with Lucide, Using inline Lucide icons and the Code Helper, and Styling, linking, and aligning Lucide icons.