<!--
{
  "documentType" : "article",
  "framework" : "professional_video_applications",
  "identifier" : "/documentation/Professional-Video-Applications/import-options",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "import-options"
}
-->

# import-options

Contain options that describe how to import events and projects into Final Cut Pro.

## Discussion

The `import-options` element can contain zero or more `option` elements. The `option` element describes options for importing events and projects into Final Cut Pro through the key-value pair in the attributes listed below.

|Attributes|Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|`key`     |A string that identifies one of the following import options: ![](spacer) `copy assets`: Copy or link assets referenced in the imported XML. Valid values are `1` (copy) and `0` (link).   ![](spacer) `library location`: Specifies the location (URL) of the library to which to add the event or project. If the specified URL represents a directory, Final Cut Pro uses the default library name. If no library exists at the location specified in the XML, Final Cut Pro creates a new library. ![](spacer) `suppress warnings`: Suppress or show warnings generated during import. Valid values are `≥1` (suppress) and `0` (show)  ![](spacer) `base url`: A URL to resolve a relative URL given in the XML as the value of the `src` attribute of a `resources` element.|
|`value`   |The value for the import option.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)