Insert File
Purpose 
Imports a file or a reference to a file into the current container field. Configures the Insert File dialog box.
Format 
Insert File [<dialog options>;<table::field>;”<filename>”;]
Options 
 •
Select Dialog options or click Specify to create a custom Insert File dialog box, filter file types, and choose storage, display, and compression options for files that are inserted into a container field. See Insert File Options dialog box.
 •
Store only a reference instructs FileMaker Pro to store only a link to a file in the container field instead of the entire file. This option may reduce the size of your FileMaker Pro file, but if you move or delete the file being referenced, FileMaker Pro won't be able to display it.
 •
Select Go to target field or click Specify to specify the container field to insert the file into.
 •
Select Specify source file or click Specify to specify the file to be inserted. For information on creating file paths in FileMaker Pro, see Creating file paths.
Compatibility 
 
Where the script step runs 
Supported 
FileMaker Pro 
Yes 
FileMaker Server scheduled script 
No 
FileMaker Go 
Yes 
Custom Web Publishing 
No 
Instant Web Publishing 
No 
Runtime solution 
Yes 
Originated in 
FileMaker Pro 6.0 or earlier
Description 
You must specify a target field, click in a field, or use the Go to Field script step before performing this script step. If you do not specify a file to insert, FileMaker Pro displays a dialog box where the user can select a file.
Note  If there is no active container field on the layout where the script is being performed, Insert File returns an error code that can be captured with the Get(LastError) function.
Examples 
Go to Field [Last Correspondence]
Insert File ["My_Letter.doc"]
The following parameters in the Insert File Options dialog box indicate that filters have been defined, files are inserted in the field, and files are compressed when possible.
Insert File [Filters;Insert;Compress when possible]
Related topics 
Script steps reference (alphabetical list)
Script steps reference (category list)
Was this topic helpful? Send feedback.