diff --git a/docs/resources/observability_instance.md b/docs/resources/observability_instance.md
index 2592b6c6..83e68b13 100644
--- a/docs/resources/observability_instance.md
+++ b/docs/resources/observability_instance.md
@@ -80,7 +80,7 @@ Required:
 
 Optional:
 
-- `global` (Attributes) Global configuration for the alerts. (see [below for nested schema](#nestedatt--alert_config--global))
+- `global` (Attributes) Global configuration for the alerts. If nothing passed the default argus config will be used. It is only possible to update the entire global part, not individual attributes. (see [below for nested schema](#nestedatt--alert_config--global))
 
 <a id="nestedatt--alert_config--receivers"></a>
 ### Nested Schema for `alert_config.receivers`
diff --git a/stackit/internal/services/observability/instance/resource.go b/stackit/internal/services/observability/instance/resource.go
index 93568dd6..b59f9f6b 100644
--- a/stackit/internal/services/observability/instance/resource.go
+++ b/stackit/internal/services/observability/instance/resource.go
@@ -727,7 +727,7 @@ func (r *instanceResource) Schema(_ context.Context, _ resource.SchemaRequest, r
 						},
 					},
 					"global": schema.SingleNestedAttribute{
-						Description: "Global configuration for the alerts.",
+						Description: "Global configuration for the alerts. If nothing passed the default argus config will be used. It is only possible to update the entire global part, not individual attributes.",
 						Optional:    true,
 						Computed:    true,
 						Attributes: map[string]schema.Attribute{