Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
The [package] section defines the basic details about the application, such as the unique package identifier, application title, and icon. This section is mandatory in every manifest file.

Fields

  • id (string, required): A unique identifier used to identify the application package. This identifier is expected to be unique across the Amazon Appstore. By convention, this identifier is used as a prefix to namespace all other ids in the package. This identifier is used to manage the lifecycle for the application packages, and must not be changed to ensure updates work seamlessly. The identifier string must follow these rules:
    • Allowed characters: uppercase letters A-Z, lowercase letters a-z, digits 0-9, dot . and underscore _.
    • Use reverse DNS notation , with minimum of 2 segments where each segment starts with a letter.
  • title (string, required): A user visible string for the name of the app. Two types are supported:
    • Hard-coded title: The title should be short to fit within a display tile without truncation.
    • Localized title: Allows different titles based on language. To use the locale feature, follow these requirements:
      • The title string must be declared in this format: - where the @text is a reserved keyword, and the title_asset_id is a non-empty resource identifier you define. title = @text/ is not allowed.
      • When the title string is defined as a localized title, the default title string must be defined in the puff.json file under assets/text under the package root.
  • icon (string, required): Image file to be used as the icon for the app within the Settings -> Applications -> Managed Installed Applications screen.
    • Required format: - where @image is a reserved keyword, and icon_file_name is the name of the image file saved under assets/image.
    • Required resolution and format: 512x512, PNG
    • Maximum file size: 1MB
    • Recommended style: light colored solid icons provide optimal visuals in the Settings menu

Last modified on October 22, 2025