n8n-nodes-notion-set-icon

This is an n8n community node that allows you to set custom icons for Notion pages.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter n8n-nodes-notion-set-icon in Enter npm package name.
4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
5. Select Install.

After installing the node, you can use it like any other node. n8n displays the node in search results in the Nodes panel.

Operations

This node supports the following operations:

Page

• Set Icon: Set a custom icon for a Notion page using either:
  • External image URL
  • Upload a local image file

Credentials

This node requires Notion Set Icon API credentials. You need to provide:

• Token V2: Your Notion token_v2 cookie value
• Space ID: Your Notion workspace space ID
• User ID: Your Notion user ID

How to get credentials

1. Token V2:

   • Open your browser's developer tools while logged into Notion
   • Go to Application/Storage > Cookies > https://www.notion.so
   • Find and copy the token_v2 value

2. Space ID & User ID:

   • In the same cookies section, look for notion-space-id and notion-user-id
   • Or inspect network requests to find these values in API calls

Compatibility

This node was developed and tested with n8n version 1.56.0+.

Usage

Setting an icon from URL

1. Add the Notion Set Icon node to your workflow
2. Configure your credentials
3. Set Icon Source to "URL"
4. Enter the Page ID (can be extracted from Notion page URL)
5. Enter the Icon URL pointing to your image

Uploading and setting an icon from file

1. Add the Notion Set Icon node to your workflow
2. Configure your credentials
3. Set Icon Source to "Upload File"
4. Enter the Page ID
5. Specify the Input Binary Field containing your image data

Page ID formats supported

The node accepts page IDs in multiple formats:

• Full UUID: 214c413b-2a68-800f-9f9a-d234e37d1380
• Notion URL: https://www.notion.so/workspace/page-title-214c413b2a68800f9f9ad234e37d1380
• Raw hex: 214c413b2a68800f9f9ad234e37d1380

Development & Testing

Local Testing Environment

This project includes a local n8n test environment for development and testing:

1. Setup Environment Variables:

   • Copy .env.example to .env: cp .env.example .env
   • Fill in your actual Notion credentials in the .env file

2. Start Test Environment:

   pnpm start
   # or
   ./start-n8n.sh

3. Development Workflow:

   • Make changes to the node code
   • Run pnpm build to rebuild the node
   • Restart n8n (Ctrl+C and run pnpm start again)
   • The changes will be automatically available in n8n

4. Access n8n: Open http://localhost:5678 in your browser

Getting Credentials for Testing

1. Token V2:

   • Open browser developer tools while logged into Notion
   • Go to Application/Storage > Cookies > https://www.notion.so
   • Find and copy the token_v2 value

2. Space ID & User ID:

   • In the same cookies section, look for notion-space-id and notion-user-id
   • Or inspect network requests to find these values in API calls

Resources

• npm package
• n8n community nodes documentation
• Notion API documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Support

If you encounter any issues or have questions, please open an issue on GitHub.