None of the official GrapesJS plugins works with the new index.d.ts
I'm closing this as related to https://github.com/GrapesJS/grapesjs/issues/5149
Read full answer below ↓Question
GrapesJS version
- I confirm to use the latest version of GrapesJS
What browser are you using?
all and none, the bug is during the build
Reproducible demo link
unnecessary
Describe the bug
How to reproduce the bug?
- create a blank project
- use NPM to install GrapesJS and a plugin (preset-webpage in this example but "works" for all official plugins)
- load GrapesJS using
import GrapeJS from 'grapesjs' - attempt to load
preset-webpageusingimport plugin from 'grapesjs-preset-webpage';
What is the expected behavior? the project build correctly and the plugin is available
What is the current behavior? the project failed to build because the d.ts of GrapeJS has changed
FYI I could have created this ticket in each official plugins but I think one ticket to remind to update all is enough
Code of Conduct
- I agree to follow this project's Code of Conduct
Answers (4)
I'm closing this as related to https://github.com/GrapesJS/grapesjs/issues/5149
That's not really the same problem, in the #5149, the bug is related on how to set plugin options during the tool initialization. Here, the bug is related to the last update of the project that has defined a new index.d.ts that is not compatible with the way of the plugins used it previously
In the previous release index.d.ts had the same signature for plugins so I'm not sure to what change you're referring to
https://github.com/GrapesJS/grapesjs/blob/095466c8cc8034e54888d67beef4cb9296c823e4/index.d.ts#L50-L53
Can you share the exact error during the build?
Thanks for reporting this, @jchautreux.
Great question about none of the official GrapesJS plugins works with the new index.d.ts. 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 #5149
Non-named plugins and options
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? all and none, the bug is during the build...
Issue #5144
Incorrect type definition for PanelManager.addPanel
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? All Reproducible demo link None Describe t...
Issue #5388
Running Headless Mode Returns Different HTML from Editor
GrapesJS version [X] I confirm to use the latest version of GrapesJS What browser are you using? ChromeV117.0.5938.62 Reproducible demo lin...
Issue #5167
usePlugin is not a function
GrapesJS version[X] I confirm to use the latest version of GrapesJSWhat browser are you using? AllReproducible demo link NoneDescribe the b...
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.