> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/connect/create-nodes/test-your-node/troubleshooting.md).

# Troubleshooting

## Credentials <a href="#credentials" id="credentials"></a>

### Error message: 'Credentials of type "\*" aren't known' <a href="#error-message-credentials-of-type-arent-known" id="error-message-credentials-of-type-arent-known"></a>

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

![Troubleshooting credentials](/files/StM1hqmTtyymHLcwJ1Xs)

## Editor UI <a href="#editor-ui" id="editor-ui"></a>

### Error message: 'There was a problem loading init data: API-Server can not be reached. It's probably down' <a href="#error-message-there-was-a-problem-loading-init-data-api-server-can-not-be-reached-its-probably-down" id="error-message-there-was-a-problem-loading-init-data-api-server-can-not-be-reached-its-probably-down"></a>

* Check that the names of the node file, node folder, and class match the path added to `packages/nodes-base/package.json`.
* Check that 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 <a href="#node-icon-doesnt-show-up-in-the-add-node-menu-and-the-editor-ui" id="node-icon-doesnt-show-up-in-the-add-node-menu-and-the-editor-ui"></a>

* 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 <a href="#node-icon-doesnt-fit" id="node-icon-doesnt-fit"></a>

* 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](https://docs.gimp.org/2.10/en/gimp-image-resize.html).
* If you use a PNG file, make sure that it's 60x60 pixels.

### Node doesn't show up in the Add Node menu <a href="#node-doesnt-show-up-in-the-add-node-menu" id="node-doesnt-show-up-in-the-add-node-menu"></a>

Check that you registered the node in the `package.json` file in your project.

### Changes to the description properties don't show in the UI on refreshing <a href="#changes-to-the-description-properties-dont-show-in-the-ui-on-refreshing" id="changes-to-the-description-properties-dont-show-in-the-ui-on-refreshing"></a>

Every time you change the description properties, you have to stop the current n8n process (`ctrl` + `c`) and run it again. You may also need to re-run `npm link`.

### Linter incorrectly warning about file name case <a href="#linter-incorrectly-warning-about-file-name-case" id="linter-incorrectly-warning-about-file-name-case"></a>

The node linter has rules for file names, including what case they should be. Windows users may encounter an issue when renaming files that causes the linter to continue giving warnings, even after you rename the files. This is due to a [known Windows issue](https://answers.microsoft.com/en-us/windows/forum/all/file-renaming-when-changing-case-doesnt-work/aa15ff7c-dd2d-4ed3-bcce-799ca90d4e58) with changing case when renaming files.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/connect/create-nodes/test-your-node/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
