medusajs/medusa · warning

Failed to fetch icon ${icon.name}. Skipping...

Error message

Failed to fetch icon ${icon.name}. Skipping...

What it means

In the design-system toolbox icon generation command, each Figma icon node is looked up in a URL map (URLData.images keyed by node_id). If the icon's node_id has no entry in that map, the icon cannot be fetched, is counted as skipped, and processing continues with the remaining icons.

Source

Thrown at packages/design-system/toolbox/src/commands/icons/command.ts:93

  const URLData = await client.getImage(FIGMA_FILE_ID, {
    ids: iconNodes.map((icon) => icon.node_id),
    format: "svg",
    scale: 1,
  })

  logger.success("Successfully fetched URLs for SVGs")

  const length = iconNodes.length

  logger.info("Transforming SVGs")
  for (let i = 0; i < length; i += 20) {
    const slice = iconNodes.slice(i, i + 20)

    const requests = slice.map(async (icon) => {
      const URL = URLData.images[icon.node_id]

      if (!URL) {
        logger.warn(`Failed to fetch icon ${icon.name}. Skipping...`)
        skippedIcons.push(icon.name)
        return
      }

      let code: string | null = null

      try {
        code = await client.getResource(URL)
      } catch (e) {
        logger.warn(`Failed to fetch icon ${icon.name}. Skipping...`)
        skippedIcons.push(icon.name)
      }

      if (!code) {
        return
      }

      const { componentName, fileName, testName, fixed } = getIconData(

View on GitHub (pinned to 5e06e544a2)

Solutions

1. Re-run the icon list fetch so node ids match the current Figma file, then regenerate
2. Verify the icon frames in Figma still exist and are included in the export/images request
3. Check the printed skipped icon names and fix or remove those nodes in Figma

if (!URLData.images[icon.node_id]) {
  skippedIcons.push(icon.name) // log and continue without fetching
}

When it happens

Trigger: Running the icons generation command against a Figma file where an icon frame/node id present in the icon list is missing from the images response — renamed/moved nodes, stale node ids, or icons excluded from the export settings.

Common situations: Figma file restructured after the icon list was generated; node ids changed when icons were moved between pages; the export request only returned images for a subset of nodes.

Related errors

• Skipped ${skippedIcons.length} icons. Check the logs for mor
• Unsupported gradient type: ${values.type}
• The gradient type "${gradient.type}" is not supported.

AI-assisted analysis of medusajs/medusa@5e06e544a2 (2026-08-27). Data as JSON: /api/errors/fbc236e9b9df1106. Report an issue: GitHub.