Defaults
If you want every page in your site to have some metadata values, a good option is to use the defaults feature.
This way, everytime you set your metadata values (either using the service or the route's data), if no value is provided for some metadata, default value will be used instead.
Remember to either use the routing module or call the service
As defaults are applied when setting metadata values. So if no metadata values are being set, no defaults will be applied. Metadata values can be set using the service or when navigating to a new route when using routing
Providing default values
This is the default for apps generated with Angular CLI before v17
Open your app.module.ts
where NgxMetaCoreModule
is imported. Provide your default values by calling NgxMetaCoreModule.forRoot
with the options object.
@NgModule({
// ...
imports: [
// ...
NgxMetaCoreModule.forRoot({
defaults: {
description: "Awesome products made real ✨"
} satisfies GlobalMetadata
}),
],
// ...
})
export class AppModule {}
Check out the example module-based app's app.module.ts
file for a full app module file example
This is the default for apps generated with Angular CLI v17 and above
Open your app.config.ts
file where provideNgxMetaCore
is provided. Provide your default values by adding a call to withNgxMetaDefaults
with the default values to set.
export const appConfig: ApplicationConfig = {
providers: [
// ...
provideNgxMetaCore(
withNgxMetaDefaults({
description: "Awesome products made real ✨"
} satisfies GlobalMetadata)
),
],
}
Check out the example standalone app's app.config.ts
file for a full config file example
Notice how the Typescript's satisfies
operator helps again ensuring the metadata values JSON matches the expected shape. For more information check metadata values JSON guide
Next steps
Library comes with some built-in modules to help you set common metadata for websites. What modules are there and what metadata they provide? Check out next section about built-in modules!
If you want to optimize your main bundle size, take a look at late loading modules guide