Newer Version Available

This content describes an older version of this product. View Latest

LightningComponentBundle

Represents a Lightning web component bundle. A bundle contains Lightning web component resources.

Special Access Rules

LightningComponentBundle components can be created only in organizations with defined namespaces.

Fields

Field Name Field Type Description
apiVersion double A double value that binds the component to a Salesforce API version.
description string A description of the Lightning web component.
isExplicitImport boolean Indicates whether imports between files are done explicitly by the developer (true) or implicitly by the framework (false).
isExposed boolean Indicates whether a component is usable in a managed package (true) or not (false).
lwcResources LwcResources[] A list of resources inside a bundle.
masterLabel string The component title that appears in the list view.
targetConfigs base64Binary Configurations for each target. Each target is a Lightning page type. For example, this configuration allows a Lightning web component to be used on a Contact record page in Lightning App Builder.
targets Targets[] A list of targets where the Lightning web component is supported. Each target is a Lightning page type that can be configured in Lightning App Builder.

LwcResources

Represents a list of resources inside a LightningComponentBundle.

Field Field Type Description
lwcResource LwcResource A resource inside a LightningComponentBundle.

LwcResource

Represents a resource inside a LightningComponentBundle.

Field Field Type Description
filePath string Required. The file path of a resource.
source base64Binary Required. The content of a resource.

Targets

Represents a list of supported containers for a Lightning web component.

Field Field Type Description
target string Specifies the type of Lightning page the component can be added to in Lightning App Builder.
Valid values are:
  • lightning__AppPage—Enables a component to be used on a Lightning app page.
  • lightning__HomePage—Enables a component to be used on a custom Lightning Home page.
  • lightning__RecordPage—Enables a component to be used on a Lightning record page, such as Account or Contact.

Declarative Metadata Sample Definition

This package.xml file retrieves all the LightningComponentBundle components in an org.

In the retrieved zip file, each Lightning web component is nested under an lwc folder.

This example shows the directory structure in the zip file of one component with a name of hello.

Here are the contents of the files in the hello directory.

Content of hello.html:

Content of hello.js:

Content of hello.js-meta.xml.

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.