> For the complete documentation index, see [llms.txt](https://docs.apolo.us/index/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apolo.us/index/apolo-flow-reference/workflow-syntax/project-configuration-syntax.md).

# Project configuration syntax

{% hint style="warning" %}
Platform project semantics differs from apolo-flow projects. Refer apolo-flow project as a set of related workflows. This collision is temporal.
{% endhint %}

By default, the project name is generated automatically based on the name of the flow folder (a folder that contains a `.apolo` subfolder for configuration YAML files).

Name autogeneration will only work if the folder's name starts with a letter or an underscore symbol (`_`) and contains only letters, digits, or underscores. `ALL_CAPS` names are not supported.

To override this, you can put the `project.yml`(or `project.yaml`) file into the `.apolo` configuration folder.

## id

Project `id` available as a `${{ project.id }}` or `${{ flow.project_id }}` context. Default value - folder name, where '.apolo' folder is located.

## owner

Optional owner name available as a `${{ project.owner }}` context. Shared projects require `owner`.

## project\_name

Platform project name, where the flow belongs to. Available as `${{ project.project_name }}`. Default value - the currently selected project in Apolo CLI configuration.

You can define jobs and workflows globally by specifying the desired project-wide behavior in the following sections of the `project.yml` file:

* defaults
* images
* volumes
* mixins

You can find detailed descriptions of how to use the `defaults`, `images`, and `volumes` sections in the corresponding parts of the [live workflows syntax](/index/apolo-flow-reference/workflow-syntax/live-workflow-syntax.md) and [batch workflow syntax](/index/apolo-flow-reference/workflow-syntax/batch-workflow-syntax.md) documentation.

You can [learn more about mixins here](/index/apolo-flow-reference/mixins.md).

All settings specified in `project.yml` will be applied by default to all jobs and workflows of this project.

## See also

* [live contexts: `flow`](/index/apolo-flow-reference/workflow-syntax/live-workflow-syntax/live-contexts.md#project-context)
* [batch contexts: `flow`](/index/apolo-flow-reference/workflow-syntax/batch-workflow-syntax/batch-contexts.md#project-context)