Skip to content

Missing metadata type definition in registry for id 'LightningOutApp'.Β #3435

@jasonsiders

Description

@jasonsiders

Summary

API v65.0 introduced a new metadata type: LightningOutApp, which represents a Lightning Out 2.0 application. However, this is not recognized as a valid metadata type, ex., when running sf project retrieve start -m LightningOutApp.

While the type is not listed in the Metadata Registry , it is listed as available in the Metadata Coverage Report for v65.0.

Without this support, we are unable to meaningfully use Lightning Out 2.0 applications w/version control.

Steps To Reproduce

  1. Ensure sfdx-project.json is using v65.0 or later.
  2. Create a Lightning Out 2.0 application, via Setup > Lightning Out 2.0 Apps > Lightning Out 2.0 App Manager > New Lightning Out 2.0 App.
  3. Run the retrieve command:
sf project retrieve start -m LightningOutApp

Expected result

The retrieve command should pull the relevant metadata for any Lightning Out 2.0 applications in the target environment.

Actual result

Error (RegistryError): Missing metadata type definition in registry for id 'LightningOutApp'.

Try this:

Did you mean one of the following types? [LightningBolt]

Confirm the metadata type name is correct. Validate against the registry at:
<https://github.com/forcedotcom/source-deploy-retrieve/blob/main/src/registry/metadataRegistry.json>

If the type is not listed in the registry, check that it has Metadata API support via the Metadata Coverage Report:
<https://developer.salesforce.com/docs/metadata-coverage>

If the type is available via Metadata API but not in the registry

- Open an issue <https://github.com/forcedotcom/cli/issues>
- Add the type via PR. Instructions: <https://github.com/forcedotcom/source-deploy-retrieve/blob/main/contributing/metadata.md>

System Information

Using zsh on macOS. Version details:

{
  "architecture": "darwin-arm64",
  "cliVersion": "@salesforce/cli/2.109.6",
  "nodeVersion": "node-v22.20.0",
  "osVersion": "Darwin 25.0.0",
  "rootPath": "/Users/jsiders/.npm-global/lib/node_modules/@salesforce/cli",
  "shell": "zsh",
  "pluginVersions": [
    "@corekraft/flow-linter 1.0.1 (user) published 62 days ago (Thu Aug 21 2025) (latest is 1.3.0)",
    "@oclif/plugin-autocomplete 3.2.35 (core)",
    "@oclif/plugin-commands 4.1.33 (core)",
    "@oclif/plugin-help 6.2.33 (core)",
    "@oclif/plugin-not-found 3.2.68 (core)",
    "@oclif/plugin-plugins 5.4.48 (core)",
    "@oclif/plugin-search 1.2.32 (core)",
    "@oclif/plugin-update 4.7.8 (core)",
    "@oclif/plugin-version 2.2.33 (core)",
    "@oclif/plugin-warn-if-update-available 3.1.48 (core)",
    "@oclif/plugin-which 3.2.40 (core)",
    "@salesforce/cli 2.109.6 (core)",
    "agent 1.24.13 (core)",
    "apex 3.8.3 (core)",
    "api 1.3.3 (core)",
    "auth 3.9.9 (core)",
    "code-analyzer 5.4.0 (user) published 58 days ago (Tue Aug 26 2025) (latest is 5.5.0)",
    "data 4.0.58 (core)",
    "deploy-retrieve 3.23.3 (core)",
    "flow 1.0.2 (user) published 184 days ago (Mon Apr 21 2025)",
    "info 3.4.88 (core)",
    "lightning-dev 3.5.1 (user) published 56 days ago (Wed Aug 27 2025) (latest is 4.5.2)",
    "limits 3.3.67 (core)",
    "marketplace 1.3.8 (core)",
    "org 5.9.32 (core)",
    "packaging 2.20.5 (core)",
    "schema 3.3.82 (core)",
    "settings 2.4.48 (core)",
    "signups 2.6.32 (user) published 130 days ago (Sun Jun 15 2025) (latest is 2.6.49)",
    "sobject 1.4.73 (core)",
    "telemetry 3.6.58 (core)",
    "templates 56.3.65 (core)",
    "trust 3.7.113 (core)",
    "user 3.6.38 (core)",
    "@salesforce/sfdx-plugin-lwc-test 1.2.1 (user) published 383 days ago (Fri Oct 04 2024)",
    "@salesforce/sfdx-scanner 4.12.0 (user) published 176 days ago (Tue Apr 29 2025)",
    "lightning-flow-scanner 3.27.0 (user) published 101 days ago (Sun Jul 13 2025) (latest is 5.7.2)",
    "sfdx-git-delta 6.16.0 (user) published 106 days ago (Tue Jul 08 2025) (latest is 6.23.0)"
  ]
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugIssue or pull request that identifies or fixes a buginvestigatingWe're actively investigating this issuevalidatedVersion information for this issue has been validated

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions