Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3    Statistic    FMM    Blog  


Creates a new list.

Component Version macOS Windows Linux Server iOS SDK
List 4.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "QuickList.New" { ; Text; Separator; RefNum } )   More


Parameter Description Example Flags
Text Initial list content. "Hello¶World¶Test" Optional
Separator The separator to use.
Can be ASCII character number (e.g. 9 for tab) or a text where we use first character as separator.
Default is newline.
"|" Optional
RefNum The desired reference number.
Leave empty for default.
"IDs" Optional


Returns reference number or error.


Creates a new list.
You can provide whatever separator you need. Default is new line characters. But works also fine with comma, semicolon or tab characters.
Please use QuickList.Free to release the list later.
QuickList reference numbers are starting at 12000 and counting up for each new list.

QuickLists can have multiple million of entries without problems. Just be aware of FileMaker's standard loop/recursion limit of 50000, which can be raised with SetRecursion function.


Creates new list:

MBS( "QuickList.New"; "Hello¶World¶Test" )

Create list with | as separator:

MBS("QuickList.New"; "Hello|World"; "|")

Parse with newline as separator:

MBS("QuickList.GetList"; MBS( "QuickList.New"; "1¶2" & Char(10) & "3" & Char(13) & "4" ))
# accepts CR and LF as delimiter.

See also

Release notes

  • Version 8.1
  • Version 7.1
    • Fixed QuickList.New to handle empty element on the end correctly.

Example Databases

Blog Entries

FileMaker Magazin

Created 21st September 2014, last changed 20th June 2021

QuickList.MatchesSubString - QuickList.Not

Feedback: Report problem or ask question.

MBS FileMaker tutorial videos

Start Chat