App.SetDockBadgeLabel
---------------------

Sets the string to be displayed in the tile's badging area.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [App](component_App.md) | [2.6](newinversion26.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "App.SetDockBadgeLabel"; Text ) 

**MBS**( **"App.SetDockBadgeLabel";** /\* Sets the string to be displayed in the tile's badging area. \*/  
**$Text**) /\* The localized string to display. This string can contain a count value or other badging information. To clear the badge string, specify an empty string "".e.g. "123" \*/ 

(old name: AppDockTile.setBadgeLabel)

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Text | The localized string to display. This string can contain a count value or other badging information. To clear the badge string, specify an empty string "". | "123" |

### Result

Returns OK on success.

### Description

Sets the string to be displayed in the tile's badging area.  
The appearance of the badge area is system defined.  
Available in macOS v10.5 and later.  
  
iOS added in 7.2, but the badge is a number.  
### Examples

Set and query dock badge:

 Set Variable \[$r ; Value:MBS ( "App.SetDockBadgeLabel"; "123" )\]  
Show Custom Dialog \[MBS ( "[App.GetDockBadgeLabel](AppGetDockBadgeLabel.md)" )\]  
Clear it:

 MBS ( "App.SetDockBadgeLabel"; "" )  
### See also

- [App.GetDockBadgeLabel](AppGetDockBadgeLabel.md)

### Release notes

- **Version 10.5**
    - Improved [App.GetDockBadgeLabel](https://www.mbsplugins.eu/AppGetDockBadgeLabel.shtml) and [App.SetDockBadgeLabel](https://www.mbsplugins.eu/AppSetDockBadgeLabel.shtml) for iOS to not cause warning message.
- **Version 7.2**
    - Implemented [App.SetDockBadgeLabel](http://www.mbsplugins.eu/AppSetDockBadgeLabel.shtml) and [App.GetDockBadgeLabel](http://www.mbsplugins.eu/AppGetDockBadgeLabel.shtml) for iOS.

### Example Databases

- [Mac only/Dock Tile](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20only/Dock%20Tile.shtml#1ScriptAnchor_)

### Blog Entries

- [MBS @ FMTraining.TV](https://www.mbsplugins.de/archive/2022-04-15/MBS_@_FMTrainingTV/monkeybreadsoftware_blog_filemaker)
- [Customize your FileMaker solution](https://www.mbsplugins.de/archive/2021-04-25/Customize_your_FileMaker_solut/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.5pr1](https://www.mbsplugins.de/archive/2020-10-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.2pr3](https://www.mbsplugins.de/archive/2017-04-19/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)
- [More customization of FileMaker solutions](https://www.mbsplugins.de/archive/2016-02-07/More_customization_of_FileMake/monkeybreadsoftware_blog_filemaker)
- [MBS Filemaker Plugin, version 2.6pr6](https://www.mbsplugins.de/archive/2012-03-12/MBS_Filemaker_Plugin_version_2/monkeybreadsoftware_blog_filemaker)
- [Add a badge to the application icon](https://www.mbsplugins.de/archive/2012-03-03/Add_a_badge_to_the_application/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 6th June 2021

  
[App.RequestUserAttention](AppRequestUserAttention.md) - [App.SetDockIcon](AppSetDockIcon.md)

[HTML Version](AppSetDockBadgeLabel.shtml)