Variable.Append
---------------

Appends text to a variable.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Variable](component_Variable.md) | [9.5](newinversion95.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "Variable.Append"; Name; Value ) 

**MBS**( **"Variable.Append";** /\* Appends text to a variable. \*/  
**$Name**; /\* the name of the variablee.g. "test" \*/   
**$Value**) /\* the value to add to the variablee.g. 5 \*/ 

(old name: FM.VariableAppend)

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Name | the name of the variable | "test" |
| Value | the value to add to the variable | 5 |

### Result

Returns new value or error.

### Description

Appends text to a variable.  
Internally does similar to [Variable.Get](VariableGet.md) to read value, then adds given parameter and stores like [Variable.Set](VariableSet.md), all in one operation, so no other script or calculation can get between.   
Creates variable, if it's not existing yet.  
### Examples

Test append function:

 Let ( \[  
  
r1 = MBS ( "Variable.Append"; "hello"; "Line 1" &amp; ¶ );  
r2 = MBS ( "Variable.Append"; "hello"; "Line 2" &amp; ¶ );  
r3 = MBS ( "Variable.Append"; "hello"; "Line 3" &amp; ¶ )  
  
\]; MBS ( "[Variable.Get](VariableGet.md)"; "hello" ) )  
<small>  
Example result:   
Line 1  
Line 2  
Line 3</small>### See also

- [Variable.AppendJSON](VariableAppendJSON.md)
- [Variable.AppendValue](VariableAppendValue.md)
- [Variable.Get](VariableGet.md)
- [Variable.PopValue](VariablePopValue.md)
- [Variable.Set](VariableSet.md)

### Release notes

- **Version 15.2**
    - Added [Variable.AppendJSON](https://www.mbsplugins.eu/VariableAppendJSON.shtml) and [Variable.PopJSON](https://www.mbsplugins.eu/VariablePopJSON.shtml) functions.
    - Added [Variable.AppendValue](https://www.mbsplugins.eu/VariableAppendValue.shtml) and [Variable.PopValue](https://www.mbsplugins.eu/VariablePopValue.shtml) functions.

### Blog Entries

- [Additional variable levels in FileMaker with MBS Plugin](https://www.mbsplugins.de/archive/2024-06-08/Additional_variable_levels_in_/monkeybreadsoftware_blog_filemaker)
- [New functions of the MBS Plugin Version 9.5](https://www.mbsplugins.de/archive/2019-11-21/New_functions_of_the_MBS_Plugi/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.5pr5](https://www.mbsplugins.de/archive/2019-10-29/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 28th October 2019 , last changed 16th April 2025

  
[Variable.Add](VariableAdd.md) - [Variable.AppendJSON](VariableAppendJSON.md)

[HTML Version](VariableAppend.shtml)