App metadata

Adobe Commerce App Management is for Beta users only and is not yet accessible to all customers.

The metadata in your app.commerce.config file identifies your application to the App Management system. This information displays in the Admin UI and helps merchants identify and manage installed apps.

Example

The following example shows a metadata configuration:

import { defineConfig } from "@adobe/aio-commerce-lib-app/config"

export default defineConfig({
  metadata: {
    id: "my-commerce-application",
    displayName: "My Commerce Application",
    description: "This is a description for my application",
    version: "1.0.0"
  },
});
Copied to your clipboard
import { defineConfig } from "@adobe/aio-commerce-lib-app/config"

export default defineConfig({
  metadata: {
    id: "my-commerce-application",
    displayName: "My Commerce Application",
    description: "This is a description for my application",
    version: "1.0.0"
  },
});

Metadata properties

The metadata contains the following properties:

Property	Type	Required	Description
`id`	string	Yes	Unique identifier for your app. Use lowercase letters, numbers, and hyphens.
`displayName`	string	Yes	Name shown in the Admin UI.
`description`	string	Yes	Brief description of your app's functionality.
`version`	string	Yes	Semantic version number.

Define your app

Business configuration

Last updated 1/26/2026

Was this helpful?

Yes

App metadata

Example.css-83mclq{margin-left:var(--spectrum-global-dimension-size-100);}

Metadata properties

Example