--- schema_version: "1" id: 737c153f735cdca17d7575348570176eaff1529244442c2e26b6922968564c8a title: WebLink collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_weblink.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_weblink.htm source_site: developer.salesforce.com content_type: documentation content_hash: cb554a2143775fe1280f72c39a5507f60d59228e1065d6fee2e30c92b1e9feeb description: Represents a custom button or link. Available in the Tooling APIfrom API version 34.0 or later. --- # WebLink Represents a custom button or link. Available in the Tooling APIfrom API version 34.0 or later. ## Supported SOAP Calls getUpdated(), query(), retrieve(), search() ## Supported REST HTTP Methods GET ## Fields | Field Name | Details | | --- | --- | | Description | Type string Properties Filter, Nillable, Sort Description A description of the button or link. | | DisplayType | Type string Properties Filter, Group, Restricted picklist, Sort Description Represents how the button or link is rendered. Valid values are: - link for a hyperlink - button for a button - massActionButton for a button attached to a related list | | EncodingKey | Type string Properties Filter, Sort Description Valid values include: - UTF-8—Unicode (UTF-8) - ISO-8859-1—General US & Western Europe (ISO-8859–1, ISO-LATIN-1) - Shift\_JIS—Japanese (Shift-JIS) - ISO-2022-JP—Japanese (JIS) - EUC-JP—Japanese (EUC-JP) - x-SJIS\_0213—Japanese (Shift-JIS\_2004) - ks\_c\_5601-1987—Korean (ks\_c\_5601-1987) - Big5—Traditional Chinese (Big5) - GB2312—Simplified Chinese (GB2312) - Big5-HKSCS—Traditional Chinese Hong Kong (Big5–HKSCS) | | EntityDefinition | Type [EntityDefinition](https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_entitydefinition.htm "Provides row-based access to metadata about standard and custom objects.") Properties Filter, Group, Sort. Description Required. Available in API version 34.0. The entity definition for the object associated with this button or link. | | EntityDefinitionId | Type string Properties Filter, Group, Sort. Description Required. ID of the record associated with the button or link. The record’s object type is in EntityDefinition. | | FullName | Type string Properties Filter, Group, Sort. Description The full name of the associated metadata object in Metadata API. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance. | | HasMenubar | Type boolean Properties Defaulted on create, Filter, Group, Sort. Description If OpenType is newWindow, this field indicates whether to show the browser menu bar for the popup window (true, or not (false). For other values of OpenType, don't specify a value here. | | HasScrollbars | Type boolean Properties Defaulted on create, Filter, Group, Sort. Description If the value of OpenType is newWindow, this field indicates whether to show the scroll bars for the window (true) or not (false). For other values of OpenType, don’t specify a value here. | | HasToolbar | Type boolean Properties Defaulted on create, Filter, Group, Sort. Description If the value of OpenType is newWindow, this field indicates whether to show the browser toolbar for the window (true) or not (false). For other values of OpenType, don’t specify a value here. | | Height | Type int Properties Filter, Group, Nillable, Sort. Description Required if the value of OpenType is newWindow. Height in pixels of the window opened by the button or link. For other values of OpenType, don’t specify a value here. | | IsResizable | Type boolean Properties Defaulted on create, Filter, Group, Sort. Description If the value of OpenType is newWindow, this field indicates whether to allow resizing of the window (true) or not (false). For other values of OpenType, don’t specify a value here. | | LinkType | Type WebLinkType enumerated list Properties Filter, Group, Restricted picklist, Sort Description Required. Represents whether the content of the button or link is specified by a URL, an sControl, a JavaScript code block, or a Visualforce page. - url - sControl - javascript - page - flow—Reserved for future use. | | ManageableState | Type ManageableState enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the manageable state of the specified component that is contained in a package: - beta - deleted - deprecated - deprecatedEditable - installed - installedEditable - released - unmanaged | | MasterLabel | Type string Properties Filter, Group, Nillable, Sort, Update Description Master label for this object. This display value is the internal label that is not translated. Limit: 240 characters. | | Metadata | Type mns:WebLink Properties Filter, Group, idLookup, Sort Description The metadata for this object as defined in the Metadata API. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance. | | Name | Type string Properties Filter, Group, idLookup, Sort Description Required. Name to display on the page. | | NamespacePrefix | Type string Properties Filter, Group, Sort. Description The namespace prefix associated with this object. Each Developer Edition organization that creates a managed package has a unique namespace prefix. Limit: 15 characters. You can refer to a component in a managed package by using the namespacePrefix\_\_componentName notation. The namespace prefix can have one of the following values: - In Developer Edition organizations, the namespace prefix is set to the namespace prefix of the organization for all objects that support it. There is an exception if an object is in an installed managed package. In that case, the object has the namespace prefix of the installed managed package. This field’s value is the namespace prefix of the Developer Edition organization of the package developer. - In organizations that are not Developer Edition organizations, NamespacePrefix is only set for objects that are part of an installed managed package. There is no namespace prefix for all other objects. | | OpenType | Type WebLinkWindowType enumerated list Properties Filter, Group, Sort Description The window style used to display the content. Valid values are: - newWindow - sidebar - noSidebar - replace - onClickJavaScript | | Position | Type WebLinkPosition enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description If the value of OpenType is newWindow, this field indicates how the new window should be displayed. Otherwise, don’t specify a value. Valid values are: - fullScreen - none - topLeft | | RequireRowSelection | Type boolean Properties Defaulted on create, Filter, Group, Sort Description If the value of OpenType is massAction, this field indicates whether to require individual row selection to execute the action for this button (true) or not (false). Otherwise, leave this field empty. | | Scontrol | Type string Properties Filter, Group, Sort Description If the value of LinkType is sControl, this field represents the name of the sControl. Otherwise, leave this field empty. | | ShowsLocation | Type boolean Properties Filter, Group, Sort Description If the value of OpenType is newWindow, this field indicates whether to show the browser location bar for the window (true) or not (false). Otherwise, leave this field empty. | | ShowsStatus | Type boolean Properties Filter, Group, Sort Description If the value of OpenType is newWindow, show the browser status bar for the window (true. Otherwise, don’t specify a value. | | Url | Type string Properties Filter, Group, Nillable, Sort Description Required. Represents the URL of the page to link to. Can include fields as tokens within the URL. Limit: 1,024 KB. If the value of LinkType is url, this field represents the URL value. If the value of LinkType is javascript, this field represents the JavaScript content. For other values of LinkType, leave this field empty. Content must be escaped in a manner consistent with XML parsing rules. | | Width | Type int Properties Filter, Group, Nillable, Sort Description The width in pixels of the window opened by the button or link. Required if the value of OpenType is newWindow. Otherwise, leave this field empty. |