---
schema_version: "1"
id: 666ab9126866608c8447c547ad2a43902cc43caadfa0748b19ea91410c3d356e
title: CustomApplicationComponent
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_customapplicationcomponent.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_customapplicationcomponent.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: db285791ea55a1cec5801ca862a7d6f591229d4f142ad966d2edd32666e559b6
description: Represents a custom console component (Visualforce page) assigned to a CustomApplication that is marked as a Salesforce console. Custom console components extend the capabilities of Salesforce console apps. See Customize a Console with Custom Components in Salesforce Classic in Salesforce Help.
---
# CustomApplicationComponent

Represents a custom console component (Visualforce page) assigned to a CustomApplication that is marked as a Salesforce console. Custom console components extend the capabilities of Salesforce console apps. See Customize a Console with Custom Components in Salesforce Classic in Salesforce Help.

## File Suffix and Directory Location

Custom application components have the suffix .customApplicationComponent and are stored in the customApplicationComponents folder.

## Version

Custom applications are available in API version 25.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| buttonIconUrl | string | The address of a page that hosts an icon for the button. |
| buttonStyle | string | The inline style used to define how the button looks. |
| buttonText | string | The label on the button used to launch the custom console component. |
| buttonWidth | int | The pixel width of the button displayed in the Salesforce console. |
| height | int | The pixel height of the window used to display the custom console component. |
| isHeightFixed | boolean | Required. Indicates whether users can change the custom console component height (false) or not (true). |
| isHidden | boolean | Required. Indicates whether the custom console component is hidden from users (true) or not (false). |
| isWidthFixed | boolean | Required. Indicates whether users can change the component width (false) or not (true). |
| visualforcePage | string | Required. Name of the Visualforce page that represents the custom console component. |
| width | int | The pixel width of the window used to display the custom console component. |

## Declarative Metadata Sample Definition

The following is the definition of a custom application component:

<?xml version="1.0" encoding="UTF-8"?>
<CustomApplicationComponent xmlns="http://soap.sforce.com/2006/04/metadata">
    <buttonIconUrl\>https://salesforce.com</buttonIconUrl\>
    <buttonStyle\>buttonStyleCSS</buttonStyle\>
    <buttonText\>buttonText</buttonText\>
    <buttonWidth\>200</buttonWidth\>
    <height\>200</height\>
    <isHeightFixed\>false</isHeightFixed\>
    <isHidden\>false</isHidden\>
    <isWidthFixed\>false</isWidthFixed\>
    <visualforcePage\>MyVisualforcePage</visualforcePage\>
    <width\>50</width\>
</CustomApplicationComponent\>

## 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](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).