--- schema_version: "1" id: 9fa5ed03f99fcc7205e5e658217b0363ec14d78eab1720fc0e4101c65607c59c title: Pill Lightning Web Component ReadMe (Managed Package) collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_pill_lightning_web_component_readme.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_pill_lightning_web_component_readme.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: ac22b34a0e3cf3f73b26354606a7f0ae93e69e359d423295ebe7e06f978ffb26 description: For the managed package runtime, this page contains a Pill LWC ReadMe for each Vlocity release. products: - Omnistudio release: "264" --- # Pill Lightning Web Component ReadMe (Managed Package) For the managed package runtime, this page contains a Pill LWC ReadMe for each Vlocity release. ![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US). ## Vlocity Insurance and Health Spring '20 The _Pill Lightning Web Component_ is an input element that displays read-only labels that can contain links and can be removed from view on demand. For example, a user can create a list of email addresses or keywords by adding options using the input field or by selecting from a list of options, which then display as read-only labels with delete buttons. The _Pill LWC_ supports custom labels. ## Available c-pill Attributes

Attribute	Value	Type	Description
freetext	true, false (Default: false)	string	If set, enables free text. To enable users to create their own pill values apart from the values provided in options, set this to true. To create a free text pill, user enters the text in the input element, then presses the enter key.
name		string	Sets the name of the element. Used by the Form Lightning Web Component.
theme	slds, nds (Default: slds)	string	Sets the theme for the pill component.
viewonly	To enable, add viewonlywithout value to the `c-pill`element.		If set, hides input field and prevents users from adding new pills.
placeholder		string	Adds text to the input element to prompt user to select from the dropdown (list of optionsto render labels). For example, "Select an option".
label		string	Adds a title for the rendered pill element.
disabled	true, false (Default: false)	boolean	To disable the input field, set to true.
options		array string	Adds the initial list of label options. You can use this attribute to restrict options for users.
value		string	To add visible labels by default, set this attribute. To add more than one label, enter a comma sepatated list, such as 'One, Two, Three'.

## Example c-pill Component ``` ``` ## Available Custom labels

Label	ApiName	Description
Press delete or backspace to remove	cmpRemove	Text visible on mouse over of the delete icon.

## Available Custom Events onremove Triggers on deleting a value. onselect Triggers on selecting an option. ## Available Methods getValue() Returns comma-separated pill values. ## Vlocity Insurance and Health Winter '20 and Vlocity CME Spring '20 The _Pill Lightning Web Component_ is an input element that displays read-only labels that can contain links and can be removed from view on demand. For example, a user can create a list of email addresses or keywords by adding options using the input field or by selecting from a list of options, which are then displayed as read-only labels with delete buttons. ## Available c-pill Attributes

Attribute	Value	Type	Description
freetext	true, false (Default: false)	string	If set, enables free text. To enable users to create their own pill values apart from the values provided in options, set this to true. To create a free text pill, user enters the text in the input element, then presses the enter key.
name		string	Sets the name of the element. Used by the Form Lightning Web Component.
theme	slds, nds (Default: slds)	string	Sets the theme for the pill component.
viewonly	To enable, add viewonly without value to the `c-pill` element.		If set, hides input field and prevents users from adding new pills.
placeholder		string	Adds text to the input element to prompt user to select from the dropdown (list of options to render labels). For example, "Select an option".
label		string	Adds a title for the rendered pill element.
disabled	true, false (Default: false)	boolean	To disable the input field, set to true.
options		array string	Adds the initial list of label options. You can use this attribute to restrict options for users.
value		string	To add visible labels by default, set this attribute. To add more than one label, enter a comma sepatated list, such as 'One, Two, Three'.

## Example c-pill Component ``` ``` ## Available Custom Events onremove Triggers on deleting a value. onselect Triggers on selecting an option. ## Available Methods getValue() Returns comma-separated pill values. ## Vlocity Insurance and Health Summer '19 and Vlocity CME Fall '19 The _Pill Lightning Web Component_ is an input element that displays read-only labels that can contain links and can be removed from view on demand. For example, a user can create a list of email addresses or keywords by adding options using the input field or by selecting from a list of options, which are then displayed as read-only labels with delete buttons. ## Available c-pill Attributes

Attribute	Value	Type	Description
freetext	true, false (Default: false)	string	If set, enables free text. To enable users to create their own pill values apart from the values provided in options, set this to true. To create a free text pill, user enters the text in the input element, then presses the enter key.
name		string	Sets the name of the element. Used by the Form Lightning Web Component.
theme	slds, nds (Default: slds)	string	Sets the theme for the pill component.
viewonly	To enable, add viewonly without value to the `c-pill`element.		If set, hides input field and prevents users from adding new pills.
placeholder		string	Adds text to the input element to prompt user to select from the dropdown (list of options to render labels). For example, ``Select an option''.
label		string	Adds a title for the rendered pill element.
disabled	true, false (Default: false)	boolean	To disable the input field, set to true.
options		array string	Adds the initial list of label options. You can use this attribute to restrict options for users.
value		string	To add visible labels by default, set this attribute. To add more than one label, enter a comma sepatated list, such as `One, Two, Three'.