extensions.ts

The extensions.ts file is the configuration file where you register all your project's extensions. It must be located in the src/ directory. It imports and registers each extension, wherever the extension lives under src/. When you move an extension file, update its import path here to maintain the connection. To see the extensions you can add, run wix generate.

The file uses a builder pattern syntax that allows you to chain extension configurations together. It follows this basic structure, where extensionType stands for the builder of the extension you register, such as dashboardPage:

Copy

The file:

  • Imports the necessary builders from @wix/astro/builders.
  • Exports a default app configuration.
  • Uses the .use() method to register extensions.

extensions.ts can also import an extension that's declared in its own .extension.ts file, described in src/extensions/. For example:

Copy

When wix 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

Did this help?