Issue #5389πŸ’¬ AnsweredOpened September 16, 2023by hannydevelop1 reactions

GrapesJS v0.21.5 Doesn't Work in NodeJS (Headless)

Quick answerby hannydevelop❀ 1

Can you check with the latest version https://github.com/GrapesJS/grapesjs/releases/tag/v0.21.6 Thank you so much @artf this works perfectly.

Read full answer below ↓

Question

GrapesJS version

  • I confirm to use the latest version of GrapesJS

What browser are you using?

ChromeV117.0.5938.62

Reproducible demo link

https://stackblitz.com/edit/node-1zsusv

Describe the bug

How to reproduce the bug? Run node index.js to start application.

What is the expected behavior? ...

What is the current behavior?

node index.js
error TypeError: grapesjs.init is not a function
    at Object.eval (file:///home/projects/node-1zsusv/index.js:95:27)
    at Object.function (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:334:156846)
    at Module._compile (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:57:14311)
    at Module._extensions..js (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:57:14990)
    at Module.load (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:57:13006)
    at Module._load (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:57:9950)
    at Function.executeUserEntryPoint [as runMain] (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:168:693)
    at https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:298:142
    at 𝐰𝐜_0x126b (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:298:162)
    at _0x5c6800 (https://node1zsusv-qefh.w-credentialless.staticblitz.com/blitz.ef0c375a.js:329:41363)

If is necessary to execute some code in order to reproduce the bug, paste it here below:

const editor = grapesjs.init({ headless: true });

Code of Conduct

  • I agree to follow this project's Code of Conduct

Answers (3)

ClaudeCodeβ€’ May 17, 2026

Thanks for reporting this, @hannydevelop.

Great question about GrapesJS v0.21.5 Doesn't Work in NodeJS (Headless). The recommended approach with GrapesJS is to use the event-driven API.

Start here:

  1. Check the GrapesJS documentation for your specific module
  2. Look for the on() event listener method
  3. Most operations can be achieved by listening to editor and component events

Common patterns:

// Listen for changes
editor.on('change', () => console.log('something changed'));

// Component lifecycle
editor.on('component:mount', (c) => console.log('component ready', c));
editor.on('component:update', (c) => console.log('component updated', c));

If you're still stuck:

  • Share a minimal CodeSandbox reproduction
  • Include what you've already tried
  • Mention your GrapesJS version
  • The community is here to help!

Related Questions and Answers

Continue research with similar issue discussions.

Paid Plugins That Match This Issue

Curated by issue keywords and label relevance to help you ship faster.

View all plugins

Loading paid plugin recommendations...

Free option

Check the open-source GrapesJS plugins on GitHub or run a quick search in our free catalog.

Browse free plugins β†’
Premium option

Premium plugins ship with support, regular updates, and production-ready features β€” save days of integration work.

Browse premium plugins β†’

Related tutorials

In-depth guides on the same topic.

All tutorials β†’

Browse Plugin Categories

Jump directly to plugin category pages on the marketplace.