# Properties (Project Management)

Project properties are separeted into several categories: **General** (i.e. out-of-the-box properties, those marked with a \* are mandatory ), **Custom properties** (i.e. defined by the Xygeni administrator) and **Tags**.

<figure><img src="/files/ncRqojUxgMoUzjnKugFo" alt=""><figcaption></figcaption></figure>

### Project's Out-of-the-box Properties <a href="#choosing_project_or_group_in_dashboard" id="choosing_project_or_group_in_dashboard"></a>

Xygeni comes with some out-of-the-box project properties (i.e. properties that are common for all the projects and part of the predefined Xygeni configuration). Out-of-the-box properties cannot be deleted (although you can freely assign values to them)

<figure><img src="/files/fkXAMCsZ1sPNEaNfx210" alt=""><figcaption></figcaption></figure>

### Project's Custom Properties <a href="#choosing_project_or_group_in_dashboard" id="choosing_project_or_group_in_dashboard"></a>

To create a Custom Property, got to Project Management page and open any project (by clicking on ![](/files/eFMlF9lM24uuAmYtztMV) icon) . A slide with the details of the project will open.

<figure><img src="/files/lznQXT0zOskpbQ8x4jRo" alt=""><figcaption></figcaption></figure>

Under the Custom Properties, you can click on the **Add property** link to define the new Custom Property.

<figure><img src="/files/En76GKsXiJsLqtoMoFpM" alt=""><figcaption></figcaption></figure>

Provide a name and the values for the custom property.

<figure><img src="/files/cB1viFY2AYfjE0Nxm0fL" alt="" width="278"><figcaption></figcaption></figure>

After saving, you will be able to see the new property added to the Custom Properties section.

<figure><img src="/files/T7YuLvkwfflKU43eM8xo" alt="" width="563"><figcaption></figcaption></figure>

Just select the appropriate value for the edited project and click on Update button to save changes.

{% hint style="info" %}
The new custom property will appear in all your projects. Until you assign a specific value for a project, the value of the custom property for that project will be empty (no value)
{% endhint %}

To delete a custom property, just click on the trash button that appears to the right of the property.

<figure><img src="/files/teux4gtnj8HKyQBDWzOV" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Once you have created a custom property, that **property can be used as a filter in the Prioritization Funnels**. Please see [Prioritization Funnels](/introduction-to-xygeni/prioritization-funnels.md) for further info.
{% endhint %}

### Setting project's Custom Properties from the CLI (-p | --prop)

The Xygeni CLI has the ability to assign a custom project property to the project under analysis.

{% hint style="info" %}
If the custom property for your project does not yet exist, it will be generated automatically.
{% endhint %}

For doing that, you should run `xygeni scan -d <dir> -p "<property_name>:<property_value>"` or `xygeni scan -d <dir> --prop "<property_name>:<property_value>"`.

You can include as much `-p` or `--prop` options as you like within the scanner execution.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xygeni.io/xygeni-administration/platform-administration/projects-management/properties-project-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
