The src/extensions/ folder is the default location for extensions you generate with wix generate, organized by type to maintain consistency. Each extension gets its own folder holding an <extension-name>.extension.ts configuration file and its implementation. For example, an event handler is created at src/extensions/backend/events/my-event/, with my-event.extension.ts and my-event.ts.
You can place extensions anywhere under src/, as long as you update their paths in extensions.ts.
Each extension's .extension.ts file declares it with a builder from @wix/astro/builders, and extensions.ts imports the file and registers the extension. For example:
wix generate creates each extension's files, including a .extension.ts file containing the builder. By default, it uses the naming pattern [extension-name].extension.ts, and you can rename these files.
Last updated: 10 November 2026