Running Headless Mode Returns Different HTML from Editor
Hi @hannydevelop you have custom component types but you didn't pass any plugins on grapesjs.init that's why the default div is applied
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://codesandbox.io/embed/quizzical-galileo-cqldjh?fontsize=14&hidenavigation=1&theme=dark
Describe the bug
How to reproduce the bug?
- Store pages using the store manager
- Try to retrieve them using headless mode
What is the expected behavior? HTML created should be the same as that of the editor, including custom tags.
What is the current behavior?
Custom tags and other non-default tags like input is transformed into div. For example, below is the normal behaviour from the editor:
<body id="ieug"><button type="button" id="i3bz">Send</button><div id="is0j" class="gjs-row"><div id="i93o" class="gjs-cell"><input type="text" id="inco"/></div></div></body>
However, here's the code from the headless mode:
<body id="ieug"><div type="button" id="i3bz">Send</div><div id="is0j" class="gjs-row"><div id="i93o" class="gjs-cell"><div type="text" id="inco"/></div></div></body>
See how input is transformed into div.
Code of Conduct
- I agree to follow this project's Code of Conduct
Answers (4)
Hi @hannydevelop you have custom component types but you didn't pass any plugins on grapesjs.init that's why the default div is applied
Hi @hannydevelop you have custom component types but you didn't pass any plugins on
grapesjs.initthat's why the defaultdivis applied
I'm sorry that I am opening this again, adding the plugin in the normal way returns an error:
TypeError: e is not a function
at /Users/ukpaiugochi/Peppu-gen/node_modules/grapesjs/dist/grapes.min.js:2:966276
at Array.forEach (<anonymous>)
at Object.init (/Users/ukpaiugochi/Peppu-gen/node_modules/grapesjs/dist/grapes.min.js:2:966215)
@hannydevelop can you please show the code?
Thanks for reporting this, @hannydevelop.
Great question about Running Headless Mode Returns Different HTML from Editor. The recommended approach with GrapesJS is to use the event-driven API.
Start here:
- Check the GrapesJS documentation for your specific module
- Look for the
on()event listener method - 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.
Issue #6445
The doc website has missing info
GrapesJS version [x] I confirm to use the latest version of GrapesJS What browser are you using? Firefox 136.0.1 (64 bits) Reproducible dem...
Issue #6348
It's possible to drag and drop literally anything inside grapesjs canvas
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? Chrome Reproducible demo link https://grap...
Issue #5607
Cannot expand previously empty layers
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? Chrome v120.0.6099.199 Reproducible demo l...
Issue #5312
Issue with rich text editor Indent action for Lists
GrapesJS version[X] I confirm to use the latest version of GrapesJSWhat browser are you using? Chrome V115Reproducible demo link https://js...
Paid Plugins That Match This Issue
Curated by issue keywords and label relevance to help you ship faster.
Loading paid plugin recommendations...
Check the open-source GrapesJS plugins on GitHub or run a quick search in our free catalog.
Browse free plugins β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.
Tutorial
Find the Right GrapesJS Plugin in Seconds: Smarter Discovery Is Live
We're shipping a set of discovery upgrades. New label filters, a proper compatibility switch for GrapesJS vs Studio, one-click and a smarter sort bar.
Tutorial
GrapesJS vs Webflow vs Tilda: What to Choose for Your Business in 2026
Choosing the right website platform in 2026 is no longer just about building a site
Tutorial
GJS Market 2.0 - Donations, Tracking, Labels and Better Product Discovery
Weβve rolled out a new set of GrapesJS marketplace updates across GJS Market, focused on improving how creators distribute products
Browse Plugin Categories
Jump directly to plugin category pages on the marketplace.