n8n-docs/docs/integrations/creating-nodes/troubleshooting-node-development.md
Deborah Barnard 0e67c296f1 wip
2022-06-09 08:31:55 +01:00

1.9 KiB

Troubleshooting

Credentials

Error message: 'Credentials of type "*" are not known'

Check that the name in the credentials array matches the name used in the property name of the credentials' class.

Troubleshooting credentials

Editor UI

Error message: 'There was a problem loading init data: API-Server can not be reached. It is probably down'

  • Check that the node's file name, class's name, and node's folder name matches the path added to packages/nodes-base/package.json.
  • Check the names used in the displayOptions property are names used by UI elements in the node.

Node icon doesn't show up in the Add Node menu and the Editor UI

  • Check that the icon is in the same folder as the node.
  • Check that it's either in PNG or SVG format.
  • When the icon property references the icon file, check that it includes the logo extension (.png or .svg) and that it prefixes it with file:. For example, file:friendGrid.png or file:friendGrid.svg.

Node icon doesn't fit

  • If you use an SVG file, make sure the canvas size is square. You can find instructions to change the canvas size of an SVG file using GIMP here.
  • If you use a PNG file, make sure that it's 60x60 pixels.

Node doesn't show up in the Add Node menu

Check that you registered the node in the packages/nodes-base/package.json file.

[TODO: does this still apply with new way of adding nodes?]

Changes to the description properties don't show in the UI on refreshing

Every time you change the description properties, you have to stop the current n8n process (ctrl + c) and run it again (npm run dev).