This article documents options that define the type, render targets, and output of a project.
See the Project Basics article for additional documentation on using projects.
Project options are specified under the project key. For example:
---
project:
  type: website
  output-dir: _site
---




title



type
Project type (default, website, or book)


render
Files to render (defaults to all files)


execute-dir
Control the working directory for computations.

file: Use the directory of the file that is currently executing.
project: Use the root directory of the project.



output-dir
Output directory


lib-dir
HTML library (JS/CSS/etc.) directory


resources
Additional file resources to be copied to output directory


preview
Options for quarto preview (see Preview)


pre-render
Scripts to run as a pre-render step


post-render
Scripts to run as a post-render step





Preview
Specify options that control the behavior of quarto preview within the preview key. For example:
---
project:
  type: website
  output-dir: _site
  preview:
    port: 4200
    browser: false
---
Available preview options include:




port
Port to listen on (defaults to random value between 3000 and 8000)


host
Hostname to bind to (defaults to 127.0.0.1)


serve
Options for external preview server (see Serve)


browser
Open a web browser to view the preview (defaults to true)


watch-inputs
Re-render input files when they change (defaults to true)


navigate
Navigate the browser automatically when outputs are updated (defaults to true)


timeout
Time (in seconds) after which to exit if there are no active clients