# Embed Cue Sheet

This function is used to import a cue sheet from the file system which will be saved in a CUESHEET UDTI. If the file path field resolves to be empty at runtime, the cue file is assumed to have the same name and folder as the associated audio file with a .cue extension.

The path may contain any of the escape sequences described in Escape Sequences. At runtime, the path to the file must be absolute (/) or relative to the home folder (~/).

While this statement is valid in all execution modes, it was designed to be run grouped. The action test state will be set to true if the import succeeded, otherwise false. The action test state's value is only reliable if the statement is run on a single file.

Note: this statement works with existing content and does not use any of the settings in Preferences-Cue Sheets.