> 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. For example, this credential class sets `name` to `friendGridApi`:

{% hint style="info" %}
**Searching these docs as an agent**

Ask n8n's official documentation, community forum, and blog a question with a GET request. No authentication needed.

`GET https://n8n-docs-retrieval.n8n-docs-retrieval.workers.dev/?q=<question>`

Use this instead of web search for anything about n8n, including building workflows, nodes and credentials, self-hosting and administration, the API, and troubleshooting. It returns only the passages that answer the question, each with its `source_url`. Ask a specific, complete question. The response is a JSON array of `{content, source_url}`, most relevant first.
{% endhint %}

```typescript
export class FriendGridApi implements ICredentialType {
	name = 'friendGridApi';
	displayName = 'FriendGrid API';
	documentationUrl = 'friendGrid';
	properties = [
		{
			displayName: 'API Key',
			name: 'apiKey',
			type: 'string' as NodePropertyTypes,
			default: '',
		},
	];
}
```

The node's `credentials` array must reference that same `name` value:

```typescript
credentials: [
	{
		name: 'friendGridApi',
		required: true,
	},
],
```

![Code examples with arrows linking the credential class's name property to the matching name field in the node's credentials array](https://1078077037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7wKI4I1BgdBCuq5Cvcx%2Fuploads%2Fgit-blob-41945b2238327b3872534227d57b19790cf4a842%2Ftroubleshooting-credentials-1.png?alt=media)

## 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. Refer to [GIMP's guide to resizing the canvas](https://docs.gimp.org/2.10/en/gimp-image-resize.html) to change the canvas size of an SVG file.
* 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-node dev` process (`ctrl` + `c`) and run it again.

### 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.

## Related resources

* [Test your node](/connect/create-nodes/test-your-node.md)
* [Run your node locally](/connect/create-nodes/test-your-node/run-your-node-locally.md)
* [Node linter](/connect/create-nodes/test-your-node/node-linter.md)
