StoreRegistration
-----------------

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Plugin](component_Plugin.md) | [3.0](newinversion30.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "StoreRegistration"; Licensee Name; Component; License Type; Expire Month; Serial number ) 

**MBS**( **"StoreRegistration";** /\* Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker. \*/  
**$Licensee Name**; /\* This is the name of the person or organization that holds the license for the plug-ine.g. Your Name \*/   
**$Component**; /\* The component that was licensed. For example "Complete" \*/   
**$License Type**; /\* Seats purchased. For example, "1 seat", "10 seats", "Developer"e.g. 1 Seat \*/   
**$Expire Month**; /\* This is the month in which the serial will expire for new versions of the plug-in in YYYYMM format. Plug-in released before the end of that month will continue to work forever. New Releases after that date will require a renewale.g. 200708 \*/   
**$Serial number**) /\* The license numbere.g. your serial number \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Licensee Name | This is the name of the person or organization that holds the license for the plug-in | Your Name |
| Component | The component that was licensed. For example "Complete" |  |
| License Type | Seats purchased. For example, "1 seat", "10 seats", "Developer" | 1 Seat |
| Expire Month | This is the month in which the serial will expire for new versions of the plug-in in YYYYMM format. Plug-in released before the end of that month will continue to work forever. New Releases after that date will require a renewal | 200708 |
| Serial number | The license number | your serial number |

### Result

Returns OK on success.

### Description

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.  
This is very useful for trainings where you want to preinstall license on FileMaker installations.  
Added Windows support in plugin version 4.4.   
  
You can clear the license with [ClearRegistration](ClearRegistration.md) function.  
Added Linux support for 7.5.  
  
Saves in preferences file on Mac and Linux, saves to registry on Windows.  
  
To store the registration on a FileMaker Server permanently, it is sufficient to call the StoreRegistration function only once by opening a file (e.g. the Registration.fmp12 file) with a OnFirstWindowOpen-Script and a single line of code like this: Set Variable \[ $r; Value: MBS( "StoreRegistration"; $name; "Complete"; "5 seat"; $date; $code) \].  
After opening it once and thus writing the registration file to the preference file, it can be closed and removed from the server.  
  
Currently on Windows the key is written encrypted to the registry into the HKEY\_CURRENT\_USER\\Software\\FileMaker\\RegistrationMBS entry. On macOS and iOS, we write a RegistrationMBS entry into the com.filemaker.client.pro12.plist file or for Claris Pro into the com.claris.pro.plist file. For Linux the license is saved to /opt/FileMaker/FileMaker Server/MBS.license file.  
  
If you use this in a vertical solution, please make sure you update the license key before updating the plugin to avoid the user seeing an error dialog about an old license. Also make sure that every major update you make calls StoreRegistration with a new key to replace the old key stored in preferences. And consider getting a multi year update from us, so you only change license key every few years.  
### Examples

Stores registration:

 $r = MBS ( "StoreRegistration"; $name ; "Complete"; "5 seat"; $date ; $code )  
Register with license values in a text field:

 Set Variable \[ $result ; Value: Evaluate("MBS (\\"StoreRegistration\\"; " &amp; Register::License &amp; ")") \]  
### See also

- [ClearRegistration](ClearRegistration.md)

### Release notes

- **Version 15.5**
    - Changed plugin information string in the FileMaker preferences dialog to include license information if it gets stored with [StoreRegistration](https://www.mbsplugins.eu/StoreRegistration.shtml) function.

### Blog Entries

- [Goodies 41: Preferences Dialog](https://www.monkeybreadsoftware.com/filemaker/SyntaxColoring/99-PreferencesDialog.shtml)
- [How to Register the MBS Plugin for FileMaker](https://www.mbsplugins.de/archive/2025-10-28/How_to_Register_the_MBS_Plugin/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 15.5pr5](https://www.mbsplugins.de/archive/2025-10-27/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Register Script for MBS Plugin](https://www.mbsplugins.de/archive/2022-01-13/Register_Script_for_MBS_Plugin/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 11.2pr1](https://www.mbsplugins.de/archive/2021-04-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Preferences dialog for Windows](https://www.mbsplugins.de/archive/2020-01-27/Preferences_dialog_for_Windows/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.5pr3](https://www.mbsplugins.de/archive/2017-10-23/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.3pr5](https://www.mbsplugins.de/archive/2017-07-10/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin debugging help](https://www.mbsplugins.de/archive/2015-02-27/MBS_FileMaker_Plugin_debugging/monkeybreadsoftware_blog_filemaker)
- [Storing Registration for MBS Filemaker Plugin](https://www.mbsplugins.de/archive/2012-11-27/Storing_Registration_for_MBS_F/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 18th August 2014 , last changed 23th August 2024

  
[StoreKit.Transactions](StoreKitTransactions.md) - [SyntaxColoring.AddContextMenuCommand](SyntaxColoringAddContextMenuCommand.md)

[HTML Version](StoreRegistration.shtml)