Global helper

This module defines a global <SanityFile> component to assist with auto-generating your file URLs. It is a lightweight functional component that simply turns the props into a valid file URL.



The Sanity asset ID (of the form file-41773b5c55bc5414ab7554a75eefddf8e2e14524-txt).

  • Type: string
  • Required

projectId and dataset

These default to the projectId and dataset passed into the module options but can be overridden.

  • Type: string


  • Type: string or boolean
  • Default: false

If set, the URL will contain a download link to that asset. If set to a string, the file will download to that filename. Otherwise, the original filename will be used (if saved in Sanity). If the original filename is not available, the id of the file will be used instead. See the Sanity documentation.


  <SanityFile asset-id="file-41773b5c55bc5414ab7554a75eefddf8e2e14524-txt" download="myfile.txt">
    <template #default="{ src }">
      <a :href="src">Click here to read this text file</a>