Example Node

Basic Example Node

Overview

The Example Node is a basic custom n8n node designed to demonstrate how to pass a string input through the workflow. It takes an input item, adds or updates a property called myString in the output JSON with the value provided by the user, and passes it along. This node is useful for testing, prototyping, or as a template for building more complex nodes.

Practical examples:

  • Adding a static or dynamic string value to each item in your workflow.
  • Testing how downstream nodes handle additional fields.
  • Using as a starting point for custom node development.

Properties

Name Type Meaning
My String string The description text (user-provided string that will be added to each item's output under the key myString).

Output

Each output item will have its json field extended with a new property:

{
  "myString": "<value of My String>"
}

If the input item already has other properties, they are preserved; only myString is added or updated.

If an error occurs and "Continue On Fail" is enabled, the output may also include:

{
  "error": <error object>,
  "pairedItem": <index>
}

This node does not output binary data.

Dependencies

  • No external services or API keys required.
  • No special n8n configuration or environment variables needed.

Troubleshooting

Common issues:

  • If the "My String" property is left empty, the output will contain an empty string for myString.
  • If an unexpected error occurs during processing and "Continue On Fail" is not enabled, the workflow will stop and display an error message.

Error messages:

  • Errors thrown will typically relate to missing or invalid parameters. If "Continue On Fail" is enabled, errors are included in the output for the affected items.
  • If you see a NodeOperationError, check that all required properties are set correctly.

Links and References

Discussion