The extensions.ts file is the configuration file where you register all your project's extensions, and the entry point the CLI reads to discover them. It must be located in the src/ directory. It calls app() and chains a .use() for each extension, wherever that extension lives under src/. When you move an extension file, update its import path here to maintain the connection.
The file uses a builder pattern syntax that allows you to chain extension configurations together.
The following example shows its basic structure, with a single dashboard page declared inline:
The file:
app and the extension builders from @wix/custom-extensions.app()..use() method to register each extension.extensions.ts can also import an extension that's declared in its own .extension.ts file, described in src/extensions/. For example:
app() also carries configuration that belongs to the project rather than to any single extension, such as the apiDir option described in src/api/.
When wix app generate creates an extension, it adds the import statement and the .use() method call that register the new extension in extensions.ts.
When you delete an extension, remove both its import statement and its .use() method call from extensions.ts.
Last updated: 10 November 2026