Register
--------

This function is used to register the Plugin.

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

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

**MBS**( **"Register";** /\* This function is used to register the Plugin. \*/  
**$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

This function is used to register the Plugin.  
If you use Server and Client licenses, be sure to register the right license for the right type.  
e.g. in your script detect if you are on the server or not.  
Before you register, you may want to check if already is registered.  
  
See also [StoreRegistration](StoreRegistration.md), IsRegistration, [IsRuntime](IsRuntime.md), [IsServer](IsServer.md) and [IsClient](IsClient.md) functions.  
  
Newer plugins since 8.4 call [StoreRegistration](StoreRegistration.md) for iOS and Server automatically, so plugin registers automatically on loading and avoid problems with process is relaunched.  
  
You can later check status with [Plugin.State](PluginState.md), [Plugin.IsLicenseKeyHidden](PluginIsLicenseKeyHidden.md) or [Plugin.IsMaintenanceExpired](PluginIsMaintenanceExpired.md) function and get licensee name with [Plugin.LicenseeName](PluginLicenseeName.md) function or seats count with [Plugin.Seats](PluginSeats.md) function.  
### Examples

Register only when needed:

 If \[MBS ("IsRegistered") ≠1\]  
 If \[MBS ("IsRuntime")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "Runtime"; 123; 123)\]  
 Else If \[MBS ("IsMobile")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "iOS"; 123; 123)\]  
 Else If \[MBS ("IsServer")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "Server"; 123; 123)\]  
 Else  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "5 seats"; 123; 123)\]  
 End If  
End If  
Register with license values in a text field:

 Set Variable \[ $result ; Value: Evaluate("MBS (\\"Register\\"; " &amp; Register::License &amp; ")") \]  
Register with Startup script for server and client:

 # in Startup Script:   
  
\#Register for client   
Perform Script \[“InitMBS”\]  
\#Register for server. Will be ignored if no server or no plugin installed on server   
Perform Script on Server \[“InitMBS”\]  
  
  
\#InitMBS script:   
  
\#Enable debug logging. Shows messages in DebugView/Console.app   
Set Variable \[$r ; Value:MBS ("Trace")\]  
\#Register if needed for right platform   
If \[MBS ("IsRegistered") = 0\]  
 If \[MBS ("IsRuntime")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "Complete"; "Runtime"; 123; 123)\]  
 Else If \[MBS ("IsServer")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "Complete"; "Server"; 123; 123)\]  
 Else If \[MBS ("IsClient")\]  
 Set Variable \[$r ; Value:MBS ("Register"; "test"; "Complete"; "5 Seats"; 123; 123)\]  
 Else  
 Set Variable \[$r ; Value:"Unknown platform: " &amp; MBS ("Platform")\]  
 End If  
 #Show errors, so developer can fix them  
 If \[$r ≠ "OK"\]  
 Show Custom Dialog \["InitMBS failed."; $r \]  
 End If  
End If  
\#May initialize other stuff   
\#like dynapdf with library in extensions folder   
If \[MBS ("[DynaPDF.IsInitialized](DynaPDFIsInitialized.md)") = 0\]  
 Set Variable \[$DynaPDFLicense ; Value:"1003637-16022016-3-8-12-685C57F..."\]  
 If \[MBS ("IsWindows")\]  
 Set Variable \[$r ; Value:MBS ( "[DynaPDF.Initialize](DynaPDFInitialize.md)"; "dynapdf.dll"; $DynaPDFLicense )\]  
 Else If \[MBS ("IsMacOSX")\]  
 Set Variable \[$r ; Value:MBS ( "[DynaPDF.Initialize](DynaPDFInitialize.md)"; "dynapdf.dylib"; $DynaPDFLicense )\]  
 Else  
 Set Variable \[$r ; Value:"Unknown platform: " &amp; MBS ("Platform")\]  
 End If  
 #Show errors, so developer can fix them  
 If \[$r ≠ "OK"\]  
 Show Custom Dialog \["InitMBS failed."; $r \]  
 End If  
End If  
### See also

- [IsClient](IsClient.md)
- [IsRegistered](IsRegistered.md)
- [IsRuntime](IsRuntime.md)
- [IsServer](IsServer.md)
- [IsWindows](IsWindows.md)
- [Platform](Platform.md)
- [Plugin.IsMaintenanceExpired](PluginIsMaintenanceExpired.md)
- [Plugin.LicenseeName](PluginLicenseeName.md)
- [Plugin.SetFunctions](PluginSetFunctions.md)
- [Trace](Trace.md)

### Release notes

- **Version 15.5**
    - Changed [DynaPDF.Initialize](https://www.mbsplugins.eu/DynaPDFInitialize.shtml) und [XL.Initialize](https://www.mbsplugins.eu/XLInitialize.shtml) to not check if you have a MBS license, so you can run this before our [Register](https://www.mbsplugins.eu/Register.shtml) function.

### Blog Entries

- [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.5pr2](https://www.mbsplugins.de/archive/2025-10-08/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Advent calendar - Door 19 - Hot Keys](https://www.mbsplugins.de/archive/2024-12-19/MBS_FileMaker_Advent_calendar_/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 Plugin Quiz](https://www.mbsplugins.de/archive/2021-04-30/MBS_Plugin_Quiz/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin registration dialogs](https://www.mbsplugins.de/archive/2018-01-29/MBS_FileMaker_Plugin_registrat/monkeybreadsoftware_blog_filemaker)
- [Print WebViewer on macOS in FileMaker](https://www.mbsplugins.de/archive/2017-11-28/Print_WebViewer_on_macOS_in_Fi/monkeybreadsoftware_blog_filemaker)
- [Properly register MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2016-09-15/Properly_register_MBS_FileMake/monkeybreadsoftware_blog_filemaker)
- [4000 functions in 10 years](https://www.mbsplugins.de/archive/2016-06-11/4000_functions_in_10_years/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin debugging help](https://www.mbsplugins.de/archive/2015-02-27/MBS_FileMaker_Plugin_debugging/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 2/2026, Seite 31](https://filemaker-magazin.de/neuigkeit/4318-Die-neue-Ausgabe-FMM_202602-steht-online)
- [Ausgabe 2/2017, Seite 37](https://filemaker-magazin.de/neuigkeit/3930-Appetithappen-FMM_201702)

This function is free to use.

Created 18th August 2014 , last changed 25th February 2026

  
[RegEx.Version](RegExVersion.md) - [Registration](Registration.md)

[HTML Version](Register.shtml)