# Properties

## Overview

Collection properties supply values like regions, naming conventions, or account-specific defaults that automatically flow into every [blueprint](https://github.com/bluebricks-dev/Bluebricks-Documentation/blob/main/orchestration/packages/creating-blueprints/README.md) deployed to the collection.

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

## How collection properties work

When a blueprint property key matches a collection property name, the collection's value is injected automatically. You define values once at the collection level, and every environment inherits them.

* Collection properties override defaults defined in the blueprint, ensuring consistent values across environments
* If a property is marked as **enforced**, environments must use that exact value (e.g., forcing all resources into `eu-west-1`)
* Properties can reference dynamic values like `${{bricks.collection.slug}}_${{bricks.environment.id}}`

<figure><picture><source srcset="/files/nzvYH6Vm4Ksfocq65GEM" media="(prefers-color-scheme: dark)"><img src="/files/KZazpp1sqHi9H4x1Tk8w" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Enforced properties are hard-coded values. If not enforced, they act as defaults that environments can override.
{% endhint %}

## How to set properties

1. Navigate to the desired collection page
2. Select **Properties** from the left side menu
3. Click **Add property**
4. Enter the name (key) and value
5. (Optional) Toggle **Enforced** to lock the value
6. Click **Save**

To delete a property, click the three-dot menu on the property row and select **Delete**.


---

# 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://bluebricks.co/docs/orchestration/collections/properties.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.
