<- Object
Object
Catalog Custom Attribute DefinitionBeta
Contains information defining a custom attribute.
The type of this custom attribute. Cannot be modified after creation. Required.
The name of this definition for API and seller-facing UI purposes. The name must be unique within the (merchant, application) pair. Required. May not be empty and may not exceed 255 characters. Can be modified after creation.
Seller-oriented description of the meaning of this Custom Attribute, any constraints that the seller should observe, etc. May be displayed as a tooltip in Square UIs.
Read only. Contains information about the application that created this custom attribute definition.
The set of Catalog Object Types that this Custom Attribute may be applied to.
Currently, only ITEM
and ITEM_VARIATION
are allowed. At least one type must be included.
The visibility of a custom attribute in seller-facing UIs (including Square Point of Sale applications and Square Dashboard). May be modified.
The visibility of a custom attribute to applications other than the application that created the attribute.
Optionally, populated when type
= STRING
, unset otherwise.
Optionally, populated when type
= NUMBER
, unset otherwise.
Populated when type
is set to SELECTION
, unset otherwise.
Read only The number of custom attributes that reference this
custom attribute definition. Set by the server in response to a ListCatalog
request with include_counts
set to true
. If the actual count is greater
than 100, custom_attribute_usage_count
will be set to 100
.
The name of the desired custom attribute key that can be used to access
the custom attribute value on catalog objects. Cannot be modified after the
custom attribute definition has been created.
Must be between 1 and 60 characters, and may only contain the characters [a-zA-Z0-9_-]
.