diff --git a/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/down.sql b/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/down.sql
new file mode 100644
index 00000000..6e67e7d1
--- /dev/null
+++ b/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/down.sql
@@ -0,0 +1,20 @@
+ALTER TABLE public.config_versions DROP COLUMN IF EXISTS description;
+ALTER TABLE public.config_versions DROP COLUMN IF EXISTS change_reason;
+
+ALTER TABLE public.functions ALTER COLUMN description DROP NOT NULL;
+ALTER TABLE public.functions ALTER COLUMN description DROP DEFAULT;
+ALTER TABLE public.functions DROP COLUMN IF EXISTS change_reason;
+
+ALTER TABLE public.functions RENAME COLUMN description TO function_description;
+
+ALTER TABLE public.type_templates DROP COLUMN IF EXISTS description;
+ALTER TABLE public.type_templates DROP COLUMN IF EXISTS change_reason;
+
+ALTER TABLE public.default_configs DROP COLUMN IF EXISTS description;
+ALTER TABLE public.default_configs DROP COLUMN IF EXISTS change_reason;
+
+ALTER TABLE public.dimensions DROP COLUMN IF EXISTS description;
+ALTER TABLE public.dimensions DROP COLUMN IF EXISTS change_reason;
+
+ALTER TABLE public.contexts DROP COLUMN IF EXISTS description;
+ALTER TABLE public.contexts DROP COLUMN IF EXISTS change_reason;
\ No newline at end of file
diff --git a/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/up.sql b/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/up.sql
new file mode 100644
index 00000000..99b82845
--- /dev/null
+++ b/crates/context_aware_config/migrations/2024-11-06-123105_add_description_and_comment_columns/up.sql
@@ -0,0 +1,21 @@
+
+ALTER TABLE public.contexts ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.contexts ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
+
+ALTER TABLE public.dimensions ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.dimensions ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
+
+ALTER TABLE public.default_configs ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.default_configs ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
+
+ALTER TABLE public.type_templates ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.type_templates ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
+
+ALTER TABLE public.functions RENAME COLUMN function_description TO description;
+ALTER TABLE public.functions ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
+
+ALTER TABLE public.functions ALTER COLUMN description SET DEFAULT '';
+ALTER TABLE public.functions ALTER COLUMN description SET NOT NULL; 
+
+ALTER TABLE public.config_versions ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.config_versions ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
\ No newline at end of file
diff --git a/crates/context_aware_config/src/api/config/handlers.rs b/crates/context_aware_config/src/api/config/handlers.rs
index 09c3ca2a..09ba0346 100644
--- a/crates/context_aware_config/src/api/config/handlers.rs
+++ b/crates/context_aware_config/src/api/config/handlers.rs
@@ -380,10 +380,31 @@ fn construct_new_payload(
             },
         )?;
 
-    return Ok(web::Json(PutReq {
-        context: context,
+    let description = match res.get("description") {
+        Some(Value::String(s)) => Some(s.clone()),
+        Some(_) => {
+            log::error!("construct new payload: Description is not a valid string");
+            return Err(bad_argument!("Description must be a string"));
+        }
+        None => None,
+    };
+
+    // Handle change_reason
+    let change_reason = res
+        .get("change_reason")
+        .and_then(|val| val.as_str())
+        .map(|s| s.to_string())
+        .ok_or_else(|| {
+            log::error!("construct new payload: Change reason not present or invalid");
+            bad_argument!("Change reason is required and must be a string")
+        })?;
+
+    Ok(web::Json(PutReq {
+        context,
         r#override: override_,
-    }));
+        description,
+        change_reason,
+    }))
 }
 
 #[allow(clippy::too_many_arguments)]
diff --git a/crates/context_aware_config/src/api/context/handlers.rs b/crates/context_aware_config/src/api/context/handlers.rs
index b0454b50..40908513 100644
--- a/crates/context_aware_config/src/api/context/handlers.rs
+++ b/crates/context_aware_config/src/api/context/handlers.rs
@@ -16,7 +16,8 @@ use diesel::{
     delete,
     r2d2::{ConnectionManager, PooledConnection},
     result::{DatabaseErrorKind::*, Error::DatabaseError},
-    Connection, ExpressionMethods, PgConnection, QueryDsl, RunQueryDsl,
+    Connection, ExpressionMethods, OptionalExtension, PgConnection, QueryDsl,
+    RunQueryDsl,
 };
 use jsonschema::{Draft, JSONSchema, ValidationError};
 use serde_json::{from_value, json, Map, Value};
@@ -198,6 +199,15 @@ fn create_ctx_from_put_req(
     tenant_config: &TenantConfig,
 ) -> superposition::Result<Context> {
     let ctx_condition = req.context.to_owned().into_inner();
+    let description = if req.description.is_none() {
+        let ctx_condition_value = Value::Object(ctx_condition.clone().into());
+        ensure_description(ctx_condition_value, conn)?
+    } else {
+        req.description
+            .clone()
+            .expect("Description should not be empty")
+    };
+    let change_reason = req.change_reason.clone();
     let condition_val = Value::Object(ctx_condition.clone().into());
     let r_override = req.r#override.clone().into_inner();
     let ctx_override = Value::Object(r_override.clone().into());
@@ -228,6 +238,8 @@ fn create_ctx_from_put_req(
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
         weight,
+        description: description,
+        change_reason,
     })
 }
 
@@ -297,6 +309,8 @@ fn db_update_override(
             dsl::override_id.eq(ctx.override_id),
             dsl::last_modified_at.eq(Utc::now().naive_utc()),
             dsl::last_modified_by.eq(user.get_email()),
+            dsl::description.eq(ctx.description),
+            dsl::change_reason.eq(ctx.change_reason),
         ))
         .get_result::<Context>(conn)?;
     Ok(get_put_resp(update_resp))
@@ -307,6 +321,8 @@ fn get_put_resp(ctx: Context) -> PutResp {
         context_id: ctx.id,
         override_id: ctx.override_id,
         weight: ctx.weight,
+        description: ctx.description,
+        change_reason: ctx.change_reason,
     }
 }
 
@@ -320,7 +336,6 @@ pub fn put(
 ) -> superposition::Result<PutResp> {
     use contexts::dsl::contexts;
     let new_ctx = create_ctx_from_put_req(req, conn, user, tenant_config)?;
-
     if already_under_txn {
         diesel::sql_query("SAVEPOINT put_ctx_savepoint").execute(conn)?;
     }
@@ -345,6 +360,28 @@ pub fn put(
     }
 }
 
+fn ensure_description(
+    context: Value,
+    transaction_conn: &mut diesel::PgConnection,
+) -> Result<String, superposition::AppError> {
+    use superposition_types::cac::schema::contexts::dsl::{
+        contexts as contexts_table, id as context_id,
+    };
+
+    let context_id_value = hash(&context);
+    let existing_context = contexts_table
+        .filter(context_id.eq(context_id_value))
+        .first::<Context>(transaction_conn)
+        .optional()?; // Query the database for existing context
+
+    match existing_context {
+        Some(ctx) => Ok(ctx.description),
+        None => Err(superposition::AppError::NotFound(format!(
+            "Description Not Provided in existing context",
+        ))),
+    }
+}
+
 #[put("")]
 async fn put_handler(
     state: Data<AppState>,
@@ -356,18 +393,43 @@ async fn put_handler(
     tenant_config: TenantConfig,
 ) -> superposition::Result<HttpResponse> {
     let tags = parse_config_tags(custom_headers.config_tags)?;
+
     let (put_response, version_id) = db_conn
         .transaction::<_, superposition::AppError, _>(|transaction_conn| {
-            let put_response =
-                put(req, transaction_conn, true, &user, &tenant_config, false).map_err(
-                    |err: superposition::AppError| {
-                        log::info!("context put failed with error: {:?}", err);
-                        err
-                    },
-                )?;
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let mut req_mut = req.into_inner();
+
+            // Use the helper function to ensure the description
+            if req_mut.description.is_none() {
+                req_mut.description = Some(ensure_description(
+                    Value::Object(req_mut.context.clone().into_inner().into()),
+                    transaction_conn,
+                )?);
+            }
+            let put_response = put(
+                Json(req_mut.clone()),
+                transaction_conn,
+                true,
+                &user,
+                &tenant_config,
+                false,
+            )
+            .map_err(|err: superposition::AppError| {
+                log::info!("context put failed with error: {:?}", err);
+                err
+            })?;
+            let description = req_mut.description.unwrap_or_default();
+            let change_reason = req_mut.change_reason;
+
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                description,
+                change_reason,
+            )?;
             Ok((put_response, version_id))
         })?;
+
     let mut http_resp = HttpResponse::Ok();
 
     http_resp.insert_header((
@@ -396,14 +458,32 @@ async fn update_override_handler(
     let tags = parse_config_tags(custom_headers.config_tags)?;
     let (override_resp, version_id) = db_conn
         .transaction::<_, superposition::AppError, _>(|transaction_conn| {
-            let override_resp =
-                put(req, transaction_conn, true, &user, &tenant_config, true).map_err(
-                    |err: superposition::AppError| {
-                        log::info!("context put failed with error: {:?}", err);
-                        err
-                    },
-                )?;
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let mut req_mut = req.into_inner();
+            if req_mut.description.is_none() {
+                req_mut.description = Some(ensure_description(
+                    Value::Object(req_mut.context.clone().into_inner().into()),
+                    transaction_conn,
+                )?);
+            }
+            let override_resp = put(
+                Json(req_mut.clone()),
+                transaction_conn,
+                true,
+                &user,
+                &tenant_config,
+                true,
+            )
+            .map_err(|err: superposition::AppError| {
+                log::info!("context put failed with error: {:?}", err);
+                err
+            })?;
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                req_mut.description.unwrap().clone(),
+                req_mut.change_reason.clone(),
+            )?;
             Ok((override_resp, version_id))
         })?;
     let mut http_resp = HttpResponse::Ok();
@@ -431,6 +511,16 @@ fn r#move(
 ) -> superposition::Result<PutResp> {
     use contexts::dsl;
     let req = req.into_inner();
+
+    let ctx_condition = req.context.to_owned().into_inner();
+    let ctx_condition_value = Value::Object(ctx_condition.clone().into());
+    let description = if req.description.is_none() {
+        ensure_description(ctx_condition_value.clone(), conn)?
+    } else {
+        req.description.expect("Description should not be empty")
+    };
+
+    let change_reason = req.change_reason.clone();
     let ctx_condition = req.context.to_owned().into_inner();
     let ctx_condition_value = Value::Object(ctx_condition.clone().into());
     let new_ctx_id = hash(&ctx_condition_value);
@@ -471,6 +561,8 @@ fn r#move(
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
         weight,
+        description: description,
+        change_reason,
     };
 
     let handle_unique_violation =
@@ -534,7 +626,14 @@ async fn move_handler(
                 log::info!("move api failed with error: {:?}", err);
                 err
             })?;
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                move_response.description.clone(),
+                move_response.change_reason.clone(),
+            )?;
+
             Ok((move_response, version_id))
         })?;
     let mut http_resp = HttpResponse::Ok();
@@ -709,12 +808,26 @@ async fn delete_context(
     #[cfg(feature = "high-performance-mode")] tenant: Tenant,
     mut db_conn: DbConnection,
 ) -> superposition::Result<HttpResponse> {
+    use superposition_types::cac::schema::contexts::dsl::{
+        contexts as contexts_table, id as context_id,
+    };
     let ctx_id = path.into_inner();
     let tags = parse_config_tags(custom_headers.config_tags)?;
     let version_id =
         db_conn.transaction::<_, superposition::AppError, _>(|transaction_conn| {
-            delete_context_api(ctx_id, user, transaction_conn)?;
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let context = contexts_table
+                .filter(context_id.eq(ctx_id.clone()))
+                .first::<Context>(transaction_conn)?;
+            delete_context_api(ctx_id.clone(), user.clone(), transaction_conn)?;
+            let description = context.description;
+            let change_reason = format!("Deleted context by {}", user.username);
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                description,
+                change_reason,
+            )?;
             Ok(version_id)
         })?;
     cfg_if::cfg_if! {
@@ -743,6 +856,9 @@ async fn bulk_operations(
 ) -> superposition::Result<HttpResponse> {
     use contexts::dsl::contexts;
     let DbConnection(mut conn) = db_conn;
+    let mut all_descriptions = Vec::new();
+    let mut all_change_reasons = Vec::new();
+
     let tags = parse_config_tags(custom_headers.config_tags)?;
     let (response, version_id) =
         conn.transaction::<_, superposition::AppError, _>(|transaction_conn| {
@@ -751,7 +867,7 @@ async fn bulk_operations(
                 match action {
                     ContextAction::Put(put_req) => {
                         let put_resp = put(
-                            Json(put_req),
+                            Json(put_req.clone()),
                             transaction_conn,
                             true,
                             &user,
@@ -765,12 +881,39 @@ async fn bulk_operations(
                             );
                             err
                         })?;
+
+                        let ctx_condition = put_req.context.to_owned().into_inner();
+                        let ctx_condition_value =
+                            Value::Object(ctx_condition.clone().into());
+
+                        let description = if put_req.description.is_none() {
+                            ensure_description(
+                                ctx_condition_value.clone(),
+                                transaction_conn,
+                            )?
+                        } else {
+                            put_req
+                                .description
+                                .expect("Description should not be empty")
+                        };
+                        all_descriptions.push(description);
+                        all_change_reasons.push(put_req.change_reason.clone());
                         response.push(ContextBulkResponse::Put(put_resp));
                     }
                     ContextAction::Delete(ctx_id) => {
+                        let context: Context = contexts
+                            .filter(id.eq(&ctx_id))
+                            .first::<Context>(transaction_conn)?;
+
                         let deleted_row = delete(contexts.filter(id.eq(&ctx_id)))
                             .execute(transaction_conn);
-                        let email: String = user.get_email();
+                        let description = context.description;
+
+                        let email: String = user.clone().get_email();
+                        let change_reason =
+                            format!("Context deleted by {}", email.clone());
+                        all_descriptions.push(description.clone());
+                        all_change_reasons.push(change_reason.clone());
                         match deleted_row {
                             // Any kind of error would rollback the tranction but explicitly returning rollback tranction allows you to rollback from any point in transaction.
                             Ok(0) => {
@@ -807,12 +950,25 @@ async fn bulk_operations(
                             );
                             err
                         })?;
+                        all_descriptions.push(move_context_resp.description.clone());
+                        all_change_reasons.push(move_context_resp.change_reason.clone());
+
                         response.push(ContextBulkResponse::Move(move_context_resp));
                     }
                 }
             }
 
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let combined_description = all_descriptions.join(",");
+
+            let combined_change_reasons = all_change_reasons.join(",");
+
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                combined_description,
+                combined_change_reasons,
+            )?;
             Ok((response, version_id))
         })?;
     let mut http_resp = HttpResponse::Ok();
@@ -835,20 +991,25 @@ async fn weight_recompute(
     #[cfg(feature = "high-performance-mode")] tenant: Tenant,
     user: User,
 ) -> superposition::Result<HttpResponse> {
-    use superposition_types::cac::schema::contexts::dsl::*;
+    use superposition_types::cac::schema::contexts::dsl::{
+        contexts, last_modified_at, last_modified_by, weight,
+    };
     let DbConnection(mut conn) = db_conn;
 
+    // Fetch all contexts from the database
     let result: Vec<Context> = contexts.load(&mut conn).map_err(|err| {
-        log::error!("failed to fetch contexts with error: {}", err);
+        log::error!("Failed to fetch contexts with error: {}", err);
         unexpected_error!("Something went wrong")
     })?;
 
+    // Get dimension data and map for weight calculation
     let dimension_data = get_dimension_data(&mut conn)?;
     let dimension_data_map = get_dimension_data_map(&dimension_data)?;
     let mut response: Vec<WeightRecomputeResponse> = vec![];
     let tags = parse_config_tags(custom_headers.config_tags)?;
 
-    let contexts_new_weight: Vec<(BigDecimal, String)> = result
+    // Recompute weights and add descriptions
+    let contexts_new_weight: Vec<(BigDecimal, String, String, String)> = result
         .clone()
         .into_iter()
         .map(|context| {
@@ -864,8 +1025,15 @@ async fn weight_recompute(
                         condition: context.value.clone(),
                         old_weight: context.weight.clone(),
                         new_weight: val.clone(),
+                        description: context.description.clone(),
+                        change_reason: context.change_reason.clone(),
                     });
-                    Ok((val, context.id.clone()))
+                    Ok((
+                        val,
+                        context.id.clone(),
+                        context.description.clone(),
+                        context.change_reason.clone(),
+                    ))
                 }
                 Err(e) => {
                     log::error!("failed to calculate context weight: {}", e);
@@ -873,26 +1041,35 @@ async fn weight_recompute(
                 }
             }
         })
-        .collect::<superposition::Result<Vec<(BigDecimal, String)>>>()?;
+        .collect::<superposition::Result<Vec<(BigDecimal, String, String, String)>>>()?;
 
+    // Update database and add config version
     let last_modified_time = Utc::now().naive_utc();
     let config_version_id =
         conn.transaction::<_, superposition::AppError, _>(|transaction_conn| {
-            for (context_weight, context_id) in contexts_new_weight {
+            for (context_weight, context_id, _description, _change_reason) in contexts_new_weight.clone() {
                 diesel::update(contexts.filter(id.eq(context_id)))
-                    .set((weight.eq(context_weight), last_modified_at.eq(last_modified_time.clone()), last_modified_by.eq(user.get_email())))
-                    .execute(transaction_conn).map_err(|err| {
+                    .set((
+                        weight.eq(context_weight),
+                        last_modified_at.eq(last_modified_time.clone()),
+                        last_modified_by.eq(user.get_email()),
+                    ))
+                    .execute(transaction_conn)
+                    .map_err(|err| {
                         log::error!(
                             "Failed to execute query while recomputing weight, error: {err}"
                         );
                         db_error!(err)
                     })?;
             }
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let description = contexts_new_weight.iter().map(|(_, _, description, _)| description.clone()).collect::<Vec<String>>().join(",");
+            let change_reason = contexts_new_weight.iter().map(|(_, _, change_reason, _)| change_reason.clone()).collect::<Vec<String>>().join(",");
+            let version_id = add_config_version(&state, tags, transaction_conn, description, change_reason)?;
             Ok(version_id)
         })?;
     #[cfg(feature = "high-performance-mode")]
     put_config_in_redis(config_version_id, state, tenant, &mut conn).await?;
+
     let mut http_resp = HttpResponse::Ok();
     http_resp.insert_header((
         AppHeader::XConfigVersion.to_string(),
diff --git a/crates/context_aware_config/src/api/context/types.rs b/crates/context_aware_config/src/api/context/types.rs
index 10bd728b..043106c3 100644
--- a/crates/context_aware_config/src/api/context/types.rs
+++ b/crates/context_aware_config/src/api/context/types.rs
@@ -9,12 +9,16 @@ use superposition_types::{
 pub struct PutReq {
     pub context: Cac<Condition>,
     pub r#override: Cac<Overrides>,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[cfg_attr(test, derive(Debug, PartialEq))] // Derive traits only when running tests
 #[derive(Deserialize, Clone)]
 pub struct MoveReq {
     pub context: Cac<Condition>,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Deserialize, Clone)]
@@ -27,6 +31,8 @@ pub struct PutResp {
     pub context_id: String,
     pub override_id: String,
     pub weight: BigDecimal,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Deserialize)]
@@ -75,12 +81,24 @@ pub struct FunctionsInfo {
     pub code: Option<String>,
 }
 
+#[derive(Serialize)]
+pub struct PriorityRecomputeResponse {
+    pub id: String,
+    pub condition: Condition,
+    pub old_priority: i32,
+    pub new_priority: i32,
+    pub description: String,
+    pub change_reason: String,
+}
+
 #[derive(Serialize)]
 pub struct WeightRecomputeResponse {
     pub id: String,
     pub condition: Condition,
     pub old_weight: BigDecimal,
     pub new_weight: BigDecimal,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[cfg(test)]
@@ -100,7 +118,9 @@ mod tests {
             },
             "override": {
                 "foo": "baz"
-            }
+            },
+            "description": "",
+            "change_reason": ""
         });
 
         let action_str = json!({
@@ -122,6 +142,8 @@ mod tests {
         let expected_action = ContextAction::Put(PutReq {
             context: context,
             r#override: override_,
+            description: Some("".to_string()),
+            change_reason: "".to_string(),
         });
 
         let action_deserialized =
diff --git a/crates/context_aware_config/src/api/default_config/handlers.rs b/crates/context_aware_config/src/api/default_config/handlers.rs
index 5fc8a3fb..a864d996 100644
--- a/crates/context_aware_config/src/api/default_config/handlers.rs
+++ b/crates/context_aware_config/src/api/default_config/handlers.rs
@@ -65,6 +65,8 @@ async fn create_default_config(
     let req = request.into_inner();
     let key = req.key;
     let tags = parse_config_tags(custom_headers.config_tags)?;
+    let description = req.description;
+    let change_reason = req.change_reason;
 
     if req.schema.is_empty() {
         return Err(bad_argument!("Schema cannot be empty."));
@@ -82,6 +84,8 @@ async fn create_default_config(
         created_at: Utc::now(),
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
+        description: description.clone(),
+        change_reason: change_reason.clone(),
     };
 
     let schema_compile_result = JSONSchema::options()
@@ -130,9 +134,16 @@ async fn create_default_config(
                         "Something went wrong, failed to create DefaultConfig"
                     )
                 })?;
-            let version_id = add_config_version(&state, tags, transaction_conn)?;
+            let version_id = add_config_version(
+                &state,
+                tags,
+                transaction_conn,
+                description,
+                change_reason,
+            )?;
             Ok(version_id)
         })?;
+
     #[cfg(feature = "high-performance-mode")]
     put_config_in_redis(version_id, state, tenant, &mut conn).await?;
     let mut http_resp = HttpResponse::Ok();
@@ -141,6 +152,7 @@ async fn create_default_config(
         AppHeader::XConfigVersion.to_string(),
         version_id.to_string(),
     ));
+
     Ok(http_resp.json(default_config))
 }
 
@@ -172,6 +184,11 @@ async fn update_default_config(
         }
     })?;
 
+    let description = req
+        .description
+        .unwrap_or_else(|| existing.description.clone());
+    let change_reason = req.change_reason;
+
     let value = req.value.unwrap_or_else(|| existing.value.clone());
     let schema = req
         .schema
@@ -191,6 +208,8 @@ async fn update_default_config(
         created_at: existing.created_at,
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
+        description: description.clone(),
+        change_reason: change_reason.clone(),
     };
 
     let jschema = JSONSchema::options()
@@ -235,7 +254,13 @@ async fn update_default_config(
                     unexpected_error!("Failed to update DefaultConfig")
                 })?;
 
-            let version_id = add_config_version(&state, tags.clone(), transaction_conn)?;
+            let version_id = add_config_version(
+                &state,
+                tags.clone(),
+                transaction_conn,
+                description,
+                change_reason,
+            )?;
 
             Ok(version_id)
         })?;
@@ -365,6 +390,12 @@ async fn delete(
                     ))
                     .execute(transaction_conn)?;
 
+                let default_config: DefaultConfig = dsl::default_configs
+                    .filter(dsl::key.eq(&key))
+                    .first::<DefaultConfig>(transaction_conn)?;
+                let description = default_config.description;
+                let change_reason = format!("Context Deleted by {}", user.get_email());
+
                 let deleted_row =
                     diesel::delete(dsl::default_configs.filter(dsl::key.eq(&key)))
                         .execute(transaction_conn);
@@ -373,7 +404,13 @@ async fn delete(
                         Err(not_found!("default config key `{}` doesn't exists", key))
                     }
                     Ok(_) => {
-                        version_id = add_config_version(&state, tags, transaction_conn)?;
+                        version_id = add_config_version(
+                            &state,
+                            tags,
+                            transaction_conn,
+                            description,
+                            change_reason,
+                        )?;
                         log::info!(
                             "default config key: {key} deleted by {}",
                             user.get_email()
diff --git a/crates/context_aware_config/src/api/default_config/types.rs b/crates/context_aware_config/src/api/default_config/types.rs
index 2bcb67be..c8a65174 100644
--- a/crates/context_aware_config/src/api/default_config/types.rs
+++ b/crates/context_aware_config/src/api/default_config/types.rs
@@ -9,6 +9,8 @@ pub struct CreateReq {
     pub value: Value,
     pub schema: Map<String, Value>,
     pub function_name: Option<String>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Deserialize)]
@@ -17,6 +19,8 @@ pub struct UpdateReq {
     pub value: Option<Value>,
     pub schema: Option<Map<String, Value>>,
     pub function_name: Option<FunctionNameEnum>,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Clone)]
diff --git a/crates/context_aware_config/src/api/dimension/handlers.rs b/crates/context_aware_config/src/api/dimension/handlers.rs
index 2d6e4f4d..c322e56b 100644
--- a/crates/context_aware_config/src/api/dimension/handlers.rs
+++ b/crates/context_aware_config/src/api/dimension/handlers.rs
@@ -76,6 +76,8 @@ async fn create(
         function_name: create_req.function_name.clone(),
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
+        description: create_req.description,
+        change_reason: create_req.change_reason,
     };
 
     conn.transaction::<_, superposition::AppError, _>(|transaction_conn| {
@@ -152,6 +154,11 @@ async fn update(
         dimension_row.schema = schema_value;
     }
 
+    dimension_row.change_reason = update_req.change_reason;
+    dimension_row.description = update_req
+        .description
+        .unwrap_or_else(|| dimension_row.description);
+
     dimension_row.function_name = match update_req.function_name {
         Some(FunctionNameEnum::Name(func_name)) => Some(func_name),
         Some(FunctionNameEnum::Remove) => None,
diff --git a/crates/context_aware_config/src/api/dimension/types.rs b/crates/context_aware_config/src/api/dimension/types.rs
index 503a6e36..6eb015d5 100644
--- a/crates/context_aware_config/src/api/dimension/types.rs
+++ b/crates/context_aware_config/src/api/dimension/types.rs
@@ -9,6 +9,8 @@ pub struct CreateReq {
     pub position: Position,
     pub schema: Value,
     pub function_name: Option<String>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Deserialize, AsRef, Deref, DerefMut, Into, Clone)]
@@ -42,6 +44,8 @@ pub struct UpdateReq {
     pub position: Option<Position>,
     pub schema: Option<Value>,
     pub function_name: Option<FunctionNameEnum>,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Clone)]
diff --git a/crates/context_aware_config/src/api/functions/handlers.rs b/crates/context_aware_config/src/api/functions/handlers.rs
index e8cffc9c..deef4df7 100644
--- a/crates/context_aware_config/src/api/functions/handlers.rs
+++ b/crates/context_aware_config/src/api/functions/handlers.rs
@@ -64,9 +64,10 @@ async fn create(
         published_at: None,
         published_by: None,
         published_runtime_version: None,
-        function_description: req.description,
+        description: req.description,
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
+        change_reason: req.change_reason,
     };
 
     let insert: Result<Function, diesel::result::Error> = diesel::insert_into(functions)
@@ -137,7 +138,7 @@ async fn update(
         draft_runtime_version: req
             .runtime_version
             .unwrap_or(result.draft_runtime_version),
-        function_description: req.description.unwrap_or(result.function_description),
+        description: req.description.unwrap_or(result.description),
         draft_edited_by: user.get_email(),
         draft_edited_at: Utc::now().naive_utc(),
         published_code: result.published_code,
@@ -146,6 +147,7 @@ async fn update(
         published_runtime_version: result.published_runtime_version,
         last_modified_at: Utc::now().naive_utc(),
         last_modified_by: user.get_email(),
+        change_reason: req.change_reason,
     };
 
     let mut updated_function = diesel::update(functions)
diff --git a/crates/context_aware_config/src/api/functions/types.rs b/crates/context_aware_config/src/api/functions/types.rs
index c09b7f7c..93d4503b 100644
--- a/crates/context_aware_config/src/api/functions/types.rs
+++ b/crates/context_aware_config/src/api/functions/types.rs
@@ -8,6 +8,7 @@ pub struct UpdateFunctionRequest {
     pub function: Option<String>,
     pub runtime_version: Option<String>,
     pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Deserialize)]
@@ -16,6 +17,7 @@ pub struct CreateFunctionRequest {
     pub function: String,
     pub runtime_version: String,
     pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Deserialize, AsRef, Deref, DerefMut, Into)]
diff --git a/crates/context_aware_config/src/api/type_templates/handlers.rs b/crates/context_aware_config/src/api/type_templates/handlers.rs
index 96919779..a4695732 100644
--- a/crates/context_aware_config/src/api/type_templates/handlers.rs
+++ b/crates/context_aware_config/src/api/type_templates/handlers.rs
@@ -1,7 +1,7 @@
 use actix_web::web::{Json, Path, Query};
 use actix_web::{delete, get, post, put, HttpResponse, Scope};
 use chrono::Utc;
-use diesel::{ExpressionMethods, QueryDsl, RunQueryDsl};
+use diesel::{ExpressionMethods, OptionalExtension, QueryDsl, RunQueryDsl};
 use jsonschema::JSONSchema;
 use serde_json::Value;
 use service_utils::service::types::DbConnection;
@@ -15,7 +15,7 @@ use superposition_types::{
     result as superposition, PaginatedResponse, User,
 };
 
-use crate::api::type_templates::types::{TypeTemplateName, TypeTemplateRequest};
+use crate::api::type_templates::types::{TypeTemplateCreateRequest, TypeTemplateName};
 
 pub fn endpoints() -> Scope {
     Scope::new("")
@@ -27,7 +27,7 @@ pub fn endpoints() -> Scope {
 
 #[post("")]
 async fn create_type(
-    request: Json<TypeTemplateRequest>,
+    request: Json<TypeTemplateCreateRequest>,
     db_conn: DbConnection,
     user: User,
 ) -> superposition::Result<HttpResponse> {
@@ -50,6 +50,8 @@ async fn create_type(
             type_templates::type_name.eq(type_name),
             type_templates::created_by.eq(user.email.clone()),
             type_templates::last_modified_by.eq(user.email.clone()),
+            type_templates::description.eq(request.description.clone()),
+            type_templates::change_reason.eq(request.change_reason.clone()),
         ))
         .get_result::<TypeTemplate>(&mut conn)
         .map_err(|err| {
@@ -78,7 +80,30 @@ async fn update_type(
             err.to_string()
         )
     })?;
+
+    let description = request.get("description").cloned();
     let type_name: String = path.into_inner().into();
+    let final_description = if description.is_none() {
+        let existing_template = type_templates::table
+            .filter(type_templates::type_name.eq(&type_name))
+            .first::<TypeTemplate>(&mut conn)
+            .optional()
+            .map_err(|err| {
+                log::error!("Failed to fetch existing type template: {}", err);
+                db_error!(err)
+            })?;
+
+        match existing_template {
+            Some(template) => template.description.clone(), // Use existing description
+            None => {
+                return Err(bad_argument!(
+                    "Description is required as the type template does not exist."
+                ));
+            }
+        }
+    } else {
+        description.unwrap().to_string()
+    };
 
     let timestamp = Utc::now().naive_utc();
     let updated_type = diesel::update(type_templates::table)
@@ -87,6 +112,7 @@ async fn update_type(
             type_templates::type_schema.eq(request.clone()),
             type_templates::last_modified_at.eq(timestamp),
             type_templates::last_modified_by.eq(user.email),
+            type_templates::description.eq(final_description),
         ))
         .get_result::<TypeTemplate>(&mut conn)
         .map_err(|err| {
diff --git a/crates/context_aware_config/src/api/type_templates/types.rs b/crates/context_aware_config/src/api/type_templates/types.rs
index d7cbbd1f..1b9c90be 100644
--- a/crates/context_aware_config/src/api/type_templates/types.rs
+++ b/crates/context_aware_config/src/api/type_templates/types.rs
@@ -4,9 +4,11 @@ use serde_json::Value;
 use superposition_types::RegexEnum;
 
 #[derive(Serialize, Deserialize, Clone, Debug)]
-pub struct TypeTemplateRequest {
+pub struct TypeTemplateCreateRequest {
     pub type_schema: Value,
     pub type_name: TypeTemplateName,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Deserialize, Clone, Debug)]
@@ -16,6 +18,8 @@ pub struct TypeTemplateResponse {
     pub created_at: String,
     pub last_modified: String,
     pub created_by: String,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Deserialize, Serialize, AsRef, Deref, DerefMut, Into, Clone)]
diff --git a/crates/context_aware_config/src/helpers.rs b/crates/context_aware_config/src/helpers.rs
index 6e187f4b..78f4ba78 100644
--- a/crates/context_aware_config/src/helpers.rs
+++ b/crates/context_aware_config/src/helpers.rs
@@ -294,6 +294,8 @@ pub fn add_config_version(
     state: &Data<AppState>,
     tags: Option<Vec<String>>,
     db_conn: &mut PooledConnection<ConnectionManager<PgConnection>>,
+    description: String,
+    change_reason: String,
 ) -> superposition::Result<i64> {
     use config_versions::dsl::config_versions;
     let version_id = generate_snowflake_id(state)?;
@@ -306,6 +308,8 @@ pub fn add_config_version(
         config_hash,
         tags,
         created_at: Utc::now().naive_utc(),
+        description,
+        change_reason,
     };
     diesel::insert_into(config_versions)
         .values(&config_version)
diff --git a/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/down.sql b/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/down.sql
new file mode 100644
index 00000000..a78f8fe2
--- /dev/null
+++ b/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/down.sql
@@ -0,0 +1,2 @@
+ALTER TABLE public.experiments DROP COLUMN IF EXISTS description;
+ALTER TABLE public.experiments DROP COLUMN IF EXISTS change_reason;
diff --git a/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/up.sql b/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/up.sql
new file mode 100644
index 00000000..17fc9a37
--- /dev/null
+++ b/crates/experimentation_platform/migrations/2024-11-21-103114_add_comment_and_description_in_experiments/up.sql
@@ -0,0 +1,2 @@
+ALTER TABLE public.experiments ADD COLUMN IF NOT EXISTS description TEXT DEFAULT '' NOT NULL;
+ALTER TABLE public.experiments ADD COLUMN IF NOT EXISTS change_reason TEXT DEFAULT '' NOT NULL;
\ No newline at end of file
diff --git a/crates/experimentation_platform/src/api/experiments/handlers.rs b/crates/experimentation_platform/src/api/experiments/handlers.rs
index 7705b55d..cfde6c37 100644
--- a/crates/experimentation_platform/src/api/experiments/handlers.rs
+++ b/crates/experimentation_platform/src/api/experiments/handlers.rs
@@ -135,6 +135,8 @@ async fn create(
     use superposition_types::experimentation::schema::experiments::dsl::experiments;
     let mut variants = req.variants.to_vec();
     let DbConnection(mut conn) = db_conn;
+    let description = req.description.clone();
+    let change_reason = req.change_reason.clone();
 
     // Checking if experiment has exactly 1 control variant, and
     // atleast 1 experimental variant
@@ -209,6 +211,8 @@ async fn create(
                 })?
                 .clone(),
             r#override: json!(variant.overrides),
+            description: Some(description.clone()),
+            change_reason: change_reason.clone(),
         };
         cac_operations.push(ContextAction::PUT(payload));
     }
@@ -278,6 +282,8 @@ async fn create(
         variants: Variants::new(variants),
         last_modified_by: user.get_email(),
         chosen_variant: None,
+        description,
+        change_reason,
     };
 
     let mut inserted_experiments = diesel::insert_into(experiments)
@@ -359,12 +365,18 @@ pub async fn conclude(
 ) -> superposition::Result<(Experiment, Option<String>)> {
     use superposition_types::experimentation::schema::experiments::dsl;
 
+    let change_reason = req.change_reason.clone();
+
     let winner_variant_id: String = req.chosen_variant.to_owned();
 
     let experiment: Experiment = dsl::experiments
         .find(experiment_id)
         .get_result::<Experiment>(&mut conn)?;
 
+    let description = match req.description.clone() {
+        Some(desc) => desc,
+        None => experiment.description.clone(),
+    };
     if matches!(experiment.status, ExperimentStatusType::CONCLUDED) {
         return Err(bad_argument!(
             "experiment with id {} is already concluded",
@@ -387,6 +399,8 @@ pub async fn conclude(
             if !experiment_context.is_empty() {
                 let context_move_req = ContextMoveReq {
                     context: experiment_context.clone(),
+                    description: description.clone(),
+                    change_reason: change_reason.clone(),
                 };
                 operations.push(ContextAction::MOVE((context_id, context_move_req)));
             } else {
@@ -663,6 +677,8 @@ async fn ramp(
 ) -> superposition::Result<Json<ExperimentResponse>> {
     let DbConnection(mut conn) = db_conn;
     let exp_id = params.into_inner();
+    let description = req.description.clone();
+    let change_reason = req.change_reason.clone();
 
     let experiment: Experiment = experiments::experiments
         .find(exp_id)
@@ -693,6 +709,8 @@ async fn ramp(
             experiments::last_modified.eq(Utc::now()),
             experiments::last_modified_by.eq(user.get_email()),
             experiments::status.eq(ExperimentStatusType::INPROGRESS),
+            experiments::description.eq(description),
+            experiments::change_reason.eq(change_reason),
         ))
         .get_result(&mut conn)?;
 
@@ -736,6 +754,8 @@ async fn update_overrides(
 ) -> superposition::Result<HttpResponse> {
     let DbConnection(mut conn) = db_conn;
     let experiment_id = params.into_inner();
+    let description = req.description.clone();
+    let change_reason = req.change_reason.clone();
 
     let payload = req.into_inner();
     let variants = payload.variants;
@@ -873,6 +893,8 @@ async fn update_overrides(
                 })?
                 .clone(),
             r#override: json!(variant.overrides),
+            description: description.clone(),
+            change_reason: change_reason.clone(),
         };
         cac_operations.push(ContextAction::PUT(payload));
     }
diff --git a/crates/experimentation_platform/src/api/experiments/types.rs b/crates/experimentation_platform/src/api/experiments/types.rs
index 6ff3c615..6ea495c9 100644
--- a/crates/experimentation_platform/src/api/experiments/types.rs
+++ b/crates/experimentation_platform/src/api/experiments/types.rs
@@ -14,6 +14,8 @@ pub struct ExperimentCreateRequest {
     pub name: String,
     pub context: Exp<Condition>,
     pub variants: Vec<Variant>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize)]
@@ -49,6 +51,8 @@ pub struct ExperimentResponse {
     pub variants: Vec<Variant>,
     pub last_modified_by: String,
     pub chosen_variant: Option<String>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 impl From<Experiment> for ExperimentResponse {
@@ -68,6 +72,8 @@ impl From<Experiment> for ExperimentResponse {
             variants: experiment.variants.into_inner(),
             last_modified_by: experiment.last_modified_by,
             chosen_variant: experiment.chosen_variant,
+            description: experiment.description,
+            change_reason: experiment.change_reason,
         }
     }
 }
@@ -77,6 +83,8 @@ impl From<Experiment> for ExperimentResponse {
 #[derive(Deserialize, Debug)]
 pub struct ConcludeExperimentRequest {
     pub chosen_variant: String,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 /********** Context Bulk API Type *************/
@@ -85,6 +93,8 @@ pub struct ConcludeExperimentRequest {
 pub struct ContextPutReq {
     pub context: Map<String, Value>,
     pub r#override: Value,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Deserialize, Serialize, Clone)]
@@ -185,6 +195,8 @@ pub struct ExperimentListFilters {
 #[derive(Deserialize, Debug)]
 pub struct RampRequest {
     pub traffic_percentage: u64,
+    pub description: String,
+    pub change_reason: String,
 }
 
 /********** Update API type ********/
@@ -198,11 +210,15 @@ pub struct VariantUpdateRequest {
 #[derive(Deserialize, Debug)]
 pub struct OverrideKeysUpdateRequest {
     pub variants: Vec<VariantUpdateRequest>,
+    pub description: Option<String>,
+    pub change_reason: String,
 }
 
 #[derive(Deserialize, Serialize, Clone)]
 pub struct ContextMoveReq {
     pub context: Map<String, Value>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Debug, Clone, Deserialize)]
diff --git a/crates/experimentation_platform/tests/experimentation_tests.rs b/crates/experimentation_platform/tests/experimentation_tests.rs
index fcbccd55..694ff81e 100644
--- a/crates/experimentation_platform/tests/experimentation_tests.rs
+++ b/crates/experimentation_platform/tests/experimentation_tests.rs
@@ -11,6 +11,7 @@ use superposition_types::{
 enum Dimensions {
     Os(String),
     Client(String),
+    #[allow(dead_code)]
     VariantIds(String),
 }
 
@@ -70,6 +71,8 @@ fn experiment_gen(
         context: context.clone(),
         variants: Variants::new(variants.clone()),
         chosen_variant: None,
+        description: "".to_string(),
+        change_reason: "".to_string(),
     }
 }
 
diff --git a/crates/frontend/src/components/context_form/utils.rs b/crates/frontend/src/components/context_form/utils.rs
index a2ce22de..2a2ad98b 100644
--- a/crates/frontend/src/components/context_form/utils.rs
+++ b/crates/frontend/src/components/context_form/utils.rs
@@ -211,6 +211,8 @@ pub fn construct_request_payload(
     overrides: Map<String, Value>,
     conditions: Vec<Condition>,
     dimensions: Vec<DimensionWithMandatory>,
+    description: String,
+    change_reason: String,
 ) -> Value {
     // Construct the override section
     let override_section: Map<String, Value> = overrides;
@@ -221,7 +223,9 @@ pub fn construct_request_payload(
     // Construct the entire request payload
     let request_payload = json!({
         "override": override_section,
-        "context": context_section
+        "context": context_section,
+        "description": description,
+        "change_reason": change_reason
     });
 
     request_payload
@@ -232,10 +236,18 @@ pub async fn create_context(
     overrides: Map<String, Value>,
     conditions: Vec<Condition>,
     dimensions: Vec<DimensionWithMandatory>,
+    description: String,
+    change_reason: String,
 ) -> Result<serde_json::Value, String> {
     let host = get_host();
     let url = format!("{host}/context");
-    let request_payload = construct_request_payload(overrides, conditions, dimensions);
+    let request_payload = construct_request_payload(
+        overrides,
+        conditions,
+        dimensions,
+        description,
+        change_reason,
+    );
     let response = request(
         url,
         reqwest::Method::PUT,
@@ -252,11 +264,18 @@ pub async fn update_context(
     overrides: Map<String, Value>,
     conditions: Vec<Condition>,
     dimensions: Vec<DimensionWithMandatory>,
+    description: String,
+    change_reason: String,
 ) -> Result<serde_json::Value, String> {
     let host = get_host();
     let url = format!("{host}/context/overrides");
-    let request_payload =
-        construct_request_payload(overrides, conditions, dimensions.clone());
+    let request_payload = construct_request_payload(
+        overrides,
+        conditions,
+        dimensions.clone(),
+        description,
+        change_reason,
+    );
     let response = request(
         url,
         reqwest::Method::PUT,
diff --git a/crates/frontend/src/components/default_config_form.rs b/crates/frontend/src/components/default_config_form.rs
index e05df156..8eaaffa9 100644
--- a/crates/frontend/src/components/default_config_form.rs
+++ b/crates/frontend/src/components/default_config_form.rs
@@ -36,6 +36,8 @@ pub fn default_config_form<NF>(
     #[prop(default = Value::Null)] config_value: Value,
     #[prop(default = None)] function_name: Option<Value>,
     #[prop(default = None)] prefix: Option<String>,
+    #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
     handle_submit: NF,
 ) -> impl IntoView
 where
@@ -49,6 +51,8 @@ where
     let (config_value_rs, config_value_ws) = create_signal(config_value);
     let (function_name_rs, function_name_ws) = create_signal(function_name);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
+    let (description_rs, description_ws) = create_signal(description);
+    let (change_reason_rs, change_reason_ws) = create_signal(change_reason);
 
     let functions_resource: Resource<String, Vec<Function>> = create_blocking_resource(
         move || tenant_rs.get(),
@@ -92,6 +96,8 @@ where
         let f_value = config_value_rs.get();
 
         let fun_name = function_name_rs.get();
+        let description = description_rs.get();
+        let change_reason = change_reason_rs.get();
 
         let create_payload = DefaultConfigCreateReq {
             key: config_key_rs.get(),
@@ -104,6 +110,8 @@ where
             schema: f_schema,
             value: f_value,
             function_name: fun_name,
+            description,
+            change_reason,
         };
 
         let handle_submit_clone = handle_submit.clone();
@@ -168,6 +176,40 @@ where
 
                 </div>
 
+                <div class="divider"></div>
+
+                <div class="form-control">
+                    <label class="label">
+                        <span class="label-text">Description</span>
+                    </label>
+                    <textarea
+                        placeholder="Enter description"
+                        class="textarea textarea-bordered w-full max-w-md"
+                        value=description_rs.get_untracked()
+                        on:change=move |ev| {
+                            let value = event_target_value(&ev);
+                            description_ws.set(value);
+                        }
+                    />
+                </div>
+
+                <div class="divider"></div>
+
+                <div class="form-control">
+                    <label class="label">
+                        <span class="label-text">change_reason</span>
+                    </label>
+                    <textarea
+                        placeholder="Enter change_reason"
+                        class="textarea textarea-bordered w-full max-w-md"
+                        value=change_reason_rs.get_untracked()
+                        on:change=move |ev| {
+                            let value = event_target_value(&ev);
+                            change_reason_ws.set(value);
+                        }
+                    />
+                </div>
+
                 <div class="divider"></div>
                 <Suspense>
                     {move || {
diff --git a/crates/frontend/src/components/default_config_form/types.rs b/crates/frontend/src/components/default_config_form/types.rs
index 9c8393a8..4ae97c07 100644
--- a/crates/frontend/src/components/default_config_form/types.rs
+++ b/crates/frontend/src/components/default_config_form/types.rs
@@ -14,4 +14,6 @@ pub struct DefaultConfigUpdateReq {
     pub schema: Value,
     pub value: Value,
     pub function_name: Option<Value>,
+    pub description: String,
+    pub change_reason: String,
 }
diff --git a/crates/frontend/src/components/dimension_form.rs b/crates/frontend/src/components/dimension_form.rs
index 44cfc915..ee9f6c1f 100644
--- a/crates/frontend/src/components/dimension_form.rs
+++ b/crates/frontend/src/components/dimension_form.rs
@@ -29,6 +29,8 @@ pub fn dimension_form<NF>(
     #[prop(default = String::new())] dimension_type: String,
     #[prop(default = Value::Null)] dimension_schema: Value,
     #[prop(default = None)] function_name: Option<Value>,
+    #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
     handle_submit: NF,
 ) -> impl IntoView
 where
@@ -41,6 +43,8 @@ where
     let (dimension_type_rs, dimension_type_ws) = create_signal(dimension_type);
     let (dimension_schema_rs, dimension_schema_ws) = create_signal(dimension_schema);
     let (function_name, set_function_name) = create_signal(function_name);
+    let (description_rs, description_ws) = create_signal(description);
+    let (change_reason_rs, change_reason_ws) = create_signal(change_reason);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
     let functions_resource: Resource<String, Vec<Function>> = create_blocking_resource(
         move || tenant_rs.get(),
@@ -82,6 +86,8 @@ where
         let dimension_name = dimension_name_rs.get();
         let function_name = function_name.get();
         let function_schema = dimension_schema_rs.get();
+        let description = description_rs.get();
+        let change_reason = change_reason_rs.get();
 
         let handle_submit_clone = handle_submit.clone();
         spawn_local({
@@ -92,6 +98,8 @@ where
                         position: Some(function_position),
                         schema: Some(function_schema),
                         function_name: function_name,
+                        description: description,
+                        change_reason: change_reason.to_string(),
                     };
                     update_dimension(tenant_rs.get(), dimension_name, update_payload)
                         .await
@@ -101,6 +109,8 @@ where
                         position: function_position,
                         schema: function_schema,
                         function_name: function_name,
+                        description,
+                        change_reason,
                     };
                     create_dimension(tenant_rs.get(), create_payload).await
                 };
@@ -140,6 +150,40 @@ where
 
             <div class="divider"></div>
 
+            <div class="form-control">
+            <label class="label">
+                <span class="label-text">Description</span>
+            </label>
+            <textarea
+                placeholder="Enter description"
+                class="textarea textarea-bordered w-full max-w-md"
+                value=description_rs.get_untracked()
+                on:change=move |ev| {
+                    let value = event_target_value(&ev);
+                    description_ws.set(value);
+                }
+            />
+        </div>
+
+        <div class="divider"></div>
+
+        <div class="form-control">
+            <label class="label">
+                <span class="label-text">change_reason</span>
+            </label>
+            <textarea
+                placeholder="Enter change_reason"
+                class="textarea textarea-bordered w-full max-w-md"
+                value=change_reason_rs.get_untracked()
+                on:change=move |ev| {
+                    let value = event_target_value(&ev);
+                    change_reason_ws.set(value);
+                }
+            />
+        </div>
+        <div class="divider"></div>
+
+
             <Suspense>
                 {move || {
                     let options = type_template_resource.get().unwrap_or(vec![]);
diff --git a/crates/frontend/src/components/dimension_form/types.rs b/crates/frontend/src/components/dimension_form/types.rs
index 9135c460..45386537 100644
--- a/crates/frontend/src/components/dimension_form/types.rs
+++ b/crates/frontend/src/components/dimension_form/types.rs
@@ -7,6 +7,8 @@ pub struct DimensionCreateReq {
     pub position: u32,
     pub schema: Value,
     pub function_name: Option<Value>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Clone)]
@@ -14,4 +16,6 @@ pub struct DimensionUpdateReq {
     pub position: Option<u32>,
     pub schema: Option<Value>,
     pub function_name: Option<Value>,
+    pub description: String,
+    pub change_reason: String,
 }
diff --git a/crates/frontend/src/components/experiment_form.rs b/crates/frontend/src/components/experiment_form.rs
index e506d933..57a03d4d 100644
--- a/crates/frontend/src/components/experiment_form.rs
+++ b/crates/frontend/src/components/experiment_form.rs
@@ -60,6 +60,8 @@ pub fn experiment_form<NF>(
     handle_submit: NF,
     default_config: Vec<DefaultConfig>,
     dimensions: Vec<DimensionWithMandatory>,
+    #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
 ) -> impl IntoView
 where
     NF: Fn() + 'static + Clone,
@@ -73,6 +75,9 @@ where
     let (f_variants, set_variants) = create_signal(init_variants);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
 
+    let (description_rs, description_ws) = create_signal(description);
+    let (change_reason_rs, change_reason_ws) = create_signal(change_reason);
+
     let handle_context_form_change = move |updated_ctx: Vec<Condition>| {
         set_context.set_untracked(updated_ctx);
     };
@@ -114,6 +119,8 @@ where
                         f_experiment_name,
                         tenant,
                         dimensions.get_value().clone(),
+                        description_rs.get(),
+                        change_reason_rs.get(),
                     )
                     .await
                 };
@@ -152,6 +159,42 @@ where
 
             <div class="divider"></div>
 
+            <div class="form-control">
+            <label class="label">
+                <span class="label-text">Description</span>
+            </label>
+            <textarea
+                placeholder="Enter description"
+                class="textarea textarea-bordered w-full max-w-md"
+                value=description_rs.get_untracked()
+                on:change=move |ev| {
+                    let value = event_target_value(&ev);
+                    description_ws.set(value);
+                }
+            />
+        </div>
+
+        <div class="divider"></div>
+
+        <div class="form-control">
+            <label class="label">
+                <span class="label-text">change_reason</span>
+            </label>
+            <textarea
+                placeholder="Enter change_reason"
+                class="textarea textarea-bordered w-full max-w-md"
+                value=change_reason_rs.get_untracked()
+                on:change=move |ev| {
+                    let value = event_target_value(&ev);
+                    change_reason_ws.set(value);
+                }
+            />
+        </div>
+
+        <div class="divider"></div>
+
+
+
             <div class="my-4">
                 {move || {
                     let context = f_context.get();
diff --git a/crates/frontend/src/components/experiment_form/types.rs b/crates/frontend/src/components/experiment_form/types.rs
index 388de232..5a3cd4c4 100644
--- a/crates/frontend/src/components/experiment_form/types.rs
+++ b/crates/frontend/src/components/experiment_form/types.rs
@@ -7,9 +7,10 @@ use crate::types::VariantFormT;
 #[derive(Serialize)]
 pub struct ExperimentCreateRequest {
     pub name: String,
-
     pub context: Value,
     pub variants: Vec<Variant>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Debug)]
diff --git a/crates/frontend/src/components/experiment_form/utils.rs b/crates/frontend/src/components/experiment_form/utils.rs
index 5f137114..02193c2d 100644
--- a/crates/frontend/src/components/experiment_form/utils.rs
+++ b/crates/frontend/src/components/experiment_form/utils.rs
@@ -21,11 +21,15 @@ pub async fn create_experiment(
     name: String,
     tenant: String,
     dimensions: Vec<DimensionWithMandatory>,
+    description: String,
+    change_reason: String,
 ) -> Result<Value, String> {
     let payload = ExperimentCreateRequest {
         name,
         variants: FromIterator::from_iter(variants),
         context: construct_context(conditions, dimensions.clone()),
+        description,
+        change_reason,
     };
 
     let _ = validate_experiment(&payload)?;
diff --git a/crates/frontend/src/components/function_form.rs b/crates/frontend/src/components/function_form.rs
index 668a8bee..53433173 100644
--- a/crates/frontend/src/components/function_form.rs
+++ b/crates/frontend/src/components/function_form.rs
@@ -22,6 +22,7 @@ pub fn function_editor<NF>(
     #[prop(default = String::from(TEMPLATE_FN))] function: String,
     #[prop(default = String::new())] runtime_version: String,
     #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
     handle_submit: NF,
 ) -> impl IntoView
 where
@@ -33,6 +34,7 @@ where
     let (runtime_version, set_runtime_version) = create_signal(runtime_version);
     let (error_message, set_error_message) = create_signal("".to_string());
     let (description, set_description) = create_signal(description);
+    let (change_reason, set_change_reason) = create_signal(change_reason);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
     if !edit {
         set_runtime_version.set("1.0.0".to_string())
@@ -47,6 +49,7 @@ where
         let f_function = function.get();
         let f_runtime_version = runtime_version.get();
         let f_description = description.get();
+        let f_change_reason = change_reason.get();
         let handle_submit_clone = handle_submit.clone();
 
         logging::log!("Function Name in editor: {:?}", function_name);
@@ -59,6 +62,7 @@ where
                         f_function,
                         f_runtime_version,
                         f_description,
+                        f_change_reason,
                         tenant,
                     )
                     .await
@@ -68,6 +72,7 @@ where
                         f_function,
                         f_runtime_version,
                         f_description,
+                        f_change_reason,
                         tenant,
                     )
                     .await
@@ -159,6 +164,26 @@ where
                                 {description.get()}
                             </textarea>
                         </div>
+                        <div class="form-control">
+                            <label class="label">
+                                <span class="label-text">Change Reason</span>
+                            </label>
+                            <textarea
+                                type="text"
+                                class="input input-bordered shadow-md"
+                                name="change_reason"
+                                id="change_reason"
+                                placeholder="explain function"
+                                on:change=move |ev| {
+                                    let value = event_target_value(&ev);
+                                    logging::log!("{:?}", value);
+                                    set_change_reason.set(value);
+                                }
+                            >
+
+                                {change_reason.get()}
+                            </textarea>
+                        </div>
 
                         <div class="flex justify-end mt-8">
                             {move || {
diff --git a/crates/frontend/src/components/function_form/types.rs b/crates/frontend/src/components/function_form/types.rs
index f4fe5897..047765d1 100644
--- a/crates/frontend/src/components/function_form/types.rs
+++ b/crates/frontend/src/components/function_form/types.rs
@@ -6,6 +6,7 @@ pub struct FunctionCreateRequest {
     pub function: String,
     pub runtime_version: String,
     pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize)]
@@ -13,4 +14,5 @@ pub struct FunctionUpdateRequest {
     pub function: String,
     pub runtime_version: String,
     pub description: String,
+    pub change_reason: String,
 }
diff --git a/crates/frontend/src/components/function_form/utils.rs b/crates/frontend/src/components/function_form/utils.rs
index d3d8dd02..ec8c17b4 100644
--- a/crates/frontend/src/components/function_form/utils.rs
+++ b/crates/frontend/src/components/function_form/utils.rs
@@ -13,6 +13,7 @@ pub async fn create_function(
     function: String,
     runtime_version: String,
     description: String,
+    change_reason: String,
     tenant: String,
 ) -> Result<Function, String> {
     let payload = FunctionCreateRequest {
@@ -20,6 +21,7 @@ pub async fn create_function(
         function,
         runtime_version,
         description,
+        change_reason,
     };
 
     let host = get_host();
@@ -40,12 +42,14 @@ pub async fn update_function(
     function: String,
     runtime_version: String,
     description: String,
+    change_reason: String,
     tenant: String,
 ) -> Result<Function, String> {
     let payload = FunctionUpdateRequest {
         function,
         runtime_version,
         description,
+        change_reason,
     };
 
     let host = get_host();
diff --git a/crates/frontend/src/components/type_template_form.rs b/crates/frontend/src/components/type_template_form.rs
index 2b3910e0..a431112c 100644
--- a/crates/frontend/src/components/type_template_form.rs
+++ b/crates/frontend/src/components/type_template_form.rs
@@ -18,6 +18,8 @@ pub fn type_template_form<NF>(
     #[prop(default = String::new())] type_name: String,
     #[prop(default = json!({"type": "number"}))] type_schema: Value,
     handle_submit: NF,
+    #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
 ) -> impl IntoView
 where
     NF: Fn() + 'static + Clone,
@@ -28,6 +30,8 @@ where
     let (type_name_rs, type_name_ws) = create_signal(type_name);
     let (type_schema_rs, type_schema_ws) = create_signal(type_schema);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
+    let (description_rs, description_ws) = create_signal(description);
+    let (change_reason_rs, change_reason_ws) = create_signal(change_reason);
 
     let on_submit = move |ev: MouseEvent| {
         req_inprogress_ws.set(true);
@@ -42,9 +46,13 @@ where
                 let result = if edit {
                     update_type(tenant_rs.get(), type_name, type_schema).await
                 } else {
+                    let description = description_rs.get();
+                    let change_reason = change_reason_rs.get();
                     let payload = json!({
                         "type_name": type_name,
-                        "type_schema": type_schema
+                        "type_schema": type_schema,
+                        "description": description,
+                        "change_reason": change_reason
                     });
                     create_type(tenant_rs.get(), payload.clone()).await
                 };
@@ -81,6 +89,39 @@ where
                 />
 
             </div>
+            <div class="divider"></div>
+
+            <div class="form-control">
+                <label class="label">
+                    <span class="label-text">Description</span>
+                </label>
+                <textarea
+                    placeholder="Enter description"
+                    class="textarea textarea-bordered w-full max-w-md"
+                    value=description_rs.get_untracked()
+                    on:change=move |ev| {
+                        let value = event_target_value(&ev);
+                        description_ws.set(value);
+                    }
+                />
+            </div>
+
+            <div class="divider"></div>
+
+            <div class="form-control">
+                <label class="label">
+                    <span class="label-text">change_reason</span>
+                </label>
+                <textarea
+                    placeholder="Enter change_reason"
+                    class="textarea textarea-bordered w-full max-w-md"
+                    value=change_reason_rs.get_untracked()
+                    on:change=move |ev| {
+                        let value = event_target_value(&ev);
+                        change_reason_ws.set(value);
+                    }
+                />
+            </div>
 
             <div class="divider"></div>
             <div class="form-control">
diff --git a/crates/frontend/src/pages/context_override.rs b/crates/frontend/src/pages/context_override.rs
index a3f88b08..33148571 100644
--- a/crates/frontend/src/pages/context_override.rs
+++ b/crates/frontend/src/pages/context_override.rs
@@ -51,12 +51,16 @@ fn form(
     edit: bool,
     default_config: Vec<DefaultConfig>,
     handle_submit: Callback<(), ()>,
+    #[prop(default = String::new())] description: String,
+    #[prop(default = String::new())] change_reason: String,
 ) -> impl IntoView {
     let tenant_rs = use_context::<ReadSignal<String>>().unwrap();
     let (context, set_context) = create_signal(context);
     let (overrides, set_overrides) = create_signal(overrides);
     let dimensions = StoredValue::new(dimensions);
     let (req_inprogess_rs, req_inprogress_ws) = create_signal(false);
+    let (description_rs, description_ws) = create_signal(description);
+    let (change_reason_rs, change_reason_ws) = create_signal(change_reason);
 
     let on_submit = move |_| {
         req_inprogress_ws.set(true);
@@ -70,6 +74,8 @@ fn form(
                     Map::from_iter(f_overrides),
                     f_context,
                     dimensions.clone(),
+                    description_rs.get(),
+                    change_reason_rs.get(),
                 )
                 .await
             } else {
@@ -78,6 +84,8 @@ fn form(
                     Map::from_iter(f_overrides),
                     f_context,
                     dimensions.clone(),
+                    description_rs.get(),
+                    change_reason_rs.get(),
                 )
                 .await
             };
@@ -108,6 +116,40 @@ fn form(
 
             disabled=edit
         />
+        <div class="divider"></div>
+
+        <div class="form-control">
+        <label class="label">
+            <span class="label-text">Description</span>
+        </label>
+        <textarea
+            placeholder="Enter description"
+            class="textarea textarea-bordered w-full max-w-md"
+            value=description_rs.get_untracked()
+            on:change=move |ev| {
+                let value = event_target_value(&ev);
+                description_ws.set(value);
+            }
+        />
+    </div>
+
+    <div class="divider"></div>
+
+    <div class="form-control">
+        <label class="label">
+            <span class="label-text">change_reason</span>
+        </label>
+        <textarea
+            placeholder="Enter change_reason"
+            class="textarea textarea-bordered w-full max-w-md"
+            value=change_reason_rs.get_untracked()
+            on:change=move |ev| {
+                let value = event_target_value(&ev);
+                change_reason_ws.set(value);
+            }
+        />
+    </div>
+    <div class="divider"></div>
         <OverrideForm
             overrides=overrides.get_untracked()
             default_config=default_config
@@ -120,6 +162,7 @@ fn form(
             }
         />
 
+
         <div class="flex justify-start w-full mt-10">
             {move || {
                 let loading = req_inprogess_rs.get();
diff --git a/crates/frontend/src/pages/function.rs b/crates/frontend/src/pages/function.rs
index 8307ef8c..17a08027 100644
--- a/crates/frontend/src/pages/function.rs
+++ b/crates/frontend/src/pages/function.rs
@@ -127,7 +127,13 @@ pub fn function_page() -> impl IntoView {
                                     <div class="stat w-2/12">
                                         <div class="stat-title">Function Description</div>
                                         <div>
-                                            {function_rs.get().function_description.to_string()}
+                                            {function_rs.get().description.to_string()}
+                                        </div>
+                                    </div>
+                                    <div class="stat w-2/12">
+                                        <div class="stat-title">Function Change Reason</div>
+                                        <div>
+                                            {function_rs.get().change_reason.to_string()}
                                         </div>
                                     </div>
                                     <div class="stat w-2/12">
@@ -429,7 +435,7 @@ pub fn function_page() -> impl IntoView {
                                                                                 function_name=function_rs.get().function_name
                                                                                 function=function_rs.get().draft_code
                                                                                 runtime_version=function_rs.get().draft_runtime_version
-                                                                                description=function_rs.get().function_description
+                                                                                description=function_rs.get().description
                                                                                 handle_submit=move || {
                                                                                     combined_resource.refetch();
                                                                                     editor_mode_ws.set(true)
diff --git a/crates/superposition_types/src/cac/models.rs b/crates/superposition_types/src/cac/models.rs
index 87355081..0f161722 100644
--- a/crates/superposition_types/src/cac/models.rs
+++ b/crates/superposition_types/src/cac/models.rs
@@ -31,6 +31,8 @@ pub struct Context {
     pub last_modified_at: NaiveDateTime,
     pub last_modified_by: String,
     pub weight: BigDecimal,
+    pub description: String,
+    pub change_reason: String,
 }
 
 impl Contextual for Context {
@@ -62,6 +64,8 @@ pub struct Dimension {
     pub last_modified_at: NaiveDateTime,
     pub last_modified_by: String,
     pub position: i32,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Deserialize, Clone, Debug)]
@@ -81,6 +85,8 @@ pub struct DefaultConfig {
     pub function_name: Option<String>,
     pub last_modified_at: NaiveDateTime,
     pub last_modified_by: String,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Deserialize, Clone, Debug)]
@@ -94,7 +100,7 @@ pub struct Function {
     pub function_name: String,
     pub published_code: Option<String>,
     pub draft_code: String,
-    pub function_description: String,
+    pub description: String,
     pub published_runtime_version: Option<String>,
     pub draft_runtime_version: String,
     pub published_at: Option<NaiveDateTime>,
@@ -103,6 +109,7 @@ pub struct Function {
     pub draft_edited_by: String,
     pub last_modified_at: NaiveDateTime,
     pub last_modified_by: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Clone, Debug)]
@@ -131,6 +138,8 @@ pub struct ConfigVersion {
     pub config_hash: String,
     pub tags: Option<Vec<String>>,
     pub created_at: NaiveDateTime,
+    pub description: String,
+    pub change_reason: String,
 }
 
 #[derive(Serialize, Deserialize, Clone, Debug)]
@@ -147,4 +156,6 @@ pub struct TypeTemplate {
     pub created_at: NaiveDateTime,
     pub last_modified_at: NaiveDateTime,
     pub last_modified_by: String,
+    pub description: String,
+    pub change_reason: String,
 }
diff --git a/crates/superposition_types/src/cac/schema.rs b/crates/superposition_types/src/cac/schema.rs
index e394187d..03da6553 100644
--- a/crates/superposition_types/src/cac/schema.rs
+++ b/crates/superposition_types/src/cac/schema.rs
@@ -7,6 +7,8 @@ diesel::table! {
         config_hash -> Text,
         tags -> Nullable<Array<Varchar>>,
         created_at -> Timestamp,
+        description -> Text,
+        change_reason -> Text,
     }
 }
 
@@ -23,6 +25,8 @@ diesel::table! {
         #[max_length = 200]
         last_modified_by -> Varchar,
         weight -> Numeric,
+        description -> Text,
+        change_reason -> Text,
     }
 }
 
@@ -37,6 +41,8 @@ diesel::table! {
         last_modified_at -> Timestamp,
         #[max_length = 200]
         last_modified_by -> Varchar,
+        description -> Text,
+        change_reason -> Text,
     }
 }
 
@@ -51,6 +57,8 @@ diesel::table! {
         #[max_length = 200]
         last_modified_by -> Varchar,
         position -> Int4,
+        description -> Text,
+        change_reason -> Text,
     }
 }
 
@@ -605,7 +613,7 @@ diesel::table! {
         function_name -> Text,
         published_code -> Nullable<Text>,
         draft_code -> Text,
-        function_description -> Text,
+        description -> Text,
         #[max_length = 16]
         published_runtime_version -> Nullable<Varchar>,
         #[max_length = 16]
@@ -617,6 +625,7 @@ diesel::table! {
         last_modified_at -> Timestamp,
         #[max_length = 200]
         last_modified_by -> Varchar,
+        change_reason -> Text,
     }
 }
 
@@ -629,6 +638,8 @@ diesel::table! {
         last_modified_at -> Timestamp,
         #[max_length = 200]
         last_modified_by -> Varchar,
+        description -> Text,
+        change_reason-> Text,
     }
 }
 
diff --git a/crates/superposition_types/src/experimentation/models.rs b/crates/superposition_types/src/experimentation/models.rs
index 09b00938..931e77f3 100644
--- a/crates/superposition_types/src/experimentation/models.rs
+++ b/crates/superposition_types/src/experimentation/models.rs
@@ -92,6 +92,8 @@ pub struct Experiment {
     pub variants: Variants,
     pub last_modified_by: String,
     pub chosen_variant: Option<String>,
+    pub description: String,
+    pub change_reason: String,
 }
 
 pub type Experiments = Vec<Experiment>;
diff --git a/crates/superposition_types/src/experimentation/schema.rs b/crates/superposition_types/src/experimentation/schema.rs
index a8676f48..120ee54b 100644
--- a/crates/superposition_types/src/experimentation/schema.rs
+++ b/crates/superposition_types/src/experimentation/schema.rs
@@ -569,6 +569,8 @@ diesel::table! {
         variants -> Json,
         last_modified_by -> Text,
         chosen_variant -> Nullable<Text>,
+        description -> Text,
+        change_reason -> Text,
     }
 }
 
diff --git a/postman/cac.postman_collection.json b/postman/cac.postman_collection.json
index a3142bdc..bba84fb3 100644
--- a/postman/cac.postman_collection.json
+++ b/postman/cac.postman_collection.json
@@ -40,7 +40,7 @@
             }
           ],
           "request": {
-            "method": "PUT",
+            "method": "POST",
             "header": [
               {
                 "key": "Authorization",
@@ -65,16 +65,15 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"}}"
+              "raw": "{\"key\":\"key.\",\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"}}"
             },
             "url": {
-              "raw": "{{host}}/default-config/key.",
+              "raw": "{{host}}/default-config",
               "host": [
                 "{{host}}"
               ],
               "path": [
-                "default-config",
-                "key."
+                "default-config"
               ]
             }
           },
@@ -97,7 +96,7 @@
             }
           ],
           "request": {
-            "method": "PUT",
+            "method": "POST",
             "header": [
               {
                 "key": "Authorization",
@@ -122,16 +121,15 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"}}"
+              "raw": "{\"key\":\"key!\",\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"}}"
             },
             "url": {
-              "raw": "{{host}}/default-config/key!",
+              "raw": "{{host}}/default-config",
               "host": [
                 "{{host}}"
               ],
               "path": [
-                "default-config",
-                "key!"
+                "default-config"
               ]
             }
           },
@@ -161,22 +159,62 @@
                   "            console.log(\"Failed to fetch config\");",
                   "            throw error;",
                   "        }",
-                  "",
                   "        const resp_obj = response.json();",
                   "        const default_configs = resp_obj.default_configs;",
-                  "",
+                  "        ",
+                  "        // Original checks for key-value",
                   "        console.log(`Checking if key=${key} with value=${value} in default_configs`);",
+                  "        pm.expect(default_configs).to.have.property(key);",
                   "        pm.expect(default_configs[key]).to.be.eq(value);",
                   "    });",
                   "}",
                   "",
+                  "// Original test cases",
                   "pm.test(\"201 check\", function () {",
                   "    pm.response.to.have.status(200);",
-                  "})",
+                  "});",
                   "",
                   "pm.test(\"Check if key added to default config\", function () {",
                   "    const key = \"key1\", value = \"value1\";",
                   "    getConfigAndTest(key, value);",
+                  "});",
+                  "",
+                  "// New test case for description and comment fields",
+                  "pm.test(\"Check if description and comment fields exist\", function () {",
+                  "    const getRequest = {",
+                  "        url: `${host}/config`,",
+                  "        method: 'GET',",
+                  "        header: {",
+                  "            'Content-Type': 'application/json',",
+                  "            'x-tenant': 'test',",
+                  "        }",
+                  "    };",
+                  "",
+                  "    pm.sendRequest(getRequest, (error, response) => {",
+                  "        if(error) {",
+                  "            console.log(\"Failed to fetch config\");",
+                  "            throw error;",
+                  "        }",
+                  "        const resp_obj = response.json();",
+                  "        console.log(\"Response:\", JSON.stringify(resp_obj, null, 2));",
+                  "        ",
+                  "        // Verify the structure of the response",
+                  "        pm.expect(resp_obj).to.have.property('default_configs');",
+                  "        const configItem = resp_obj.default_configs.key1;",
+                  "        ",
+                  "        // If the config is returned as an object",
+                  "        if (typeof configItem === 'object') {",
+                  "            pm.expect(configItem).to.have.property('value');",
+                  "            pm.expect(configItem).to.have.property('description');",
+                  "            pm.expect(configItem).to.have.property('change_reason');",
+                  "        }",
+                  "        // If it's just the value directly",
+                  "        else {",
+                  "            // The original format is maintained",
+                  "            pm.expect(resp_obj.default_configs).to.have.property('description');",
+                  "            pm.expect(resp_obj.default_configs).to.have.property('change_reason');",
+                  "        }",
+                  "    });",
                   "});"
                 ],
                 "type": "text/javascript"
@@ -184,7 +222,7 @@
             }
           ],
           "request": {
-            "method": "PUT",
+            "method": "POST",
             "header": [
               {
                 "key": "Authorization",
@@ -209,16 +247,15 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"}}"
+              "raw": "{\"key\":\"key1\",\"value\":\"value1\",\"schema\":{\"type\":\"string\",\"pattern\":\".*\"},\"description\":\"description\",\"change_reason\":\"change_reason\"}"
             },
             "url": {
-              "raw": "{{host}}/default-config/key1",
+              "raw": "{{host}}/default-config",
               "host": [
                 "{{host}}"
               ],
               "path": [
-                "default-config",
-                "key1"
+                "default-config"
               ]
             }
           },
@@ -235,20 +272,23 @@
                   "",
                   "function add_default_config() {",
                   "    const options = {",
-                  "        'method': 'PUT',",
-                  "        'url': `${host}/default-config/key2`,",
+                  "        'method': 'POST',",
+                  "        'url': `${host}/default-config`,",
                   "        'header': {",
                   "            'x-tenant': 'test',",
                   "            'Content-Type': 'application/json'",
                   "        },",
                   "        \"body\": {",
                   "            \"mode\": \"raw\",",
-                  "            \"raw\": JSON.stringify({",
+                  "            \"raw\": JSON.stringify({ ",
+                  "                \"key\": \"key2\",",
                   "                \"value\": \"value1\",",
                   "                \"schema\": {",
                   "                    \"type\": \"string\",",
                   "                    \"pattern\": \".*\"",
-                  "                }",
+                  "                }, ",
+                  "                \"description\": \"description\",",
+                  "                \"change_reason\": \"change_reason\"",
                   "            })",
                   "        }",
                   "    };",
@@ -426,8 +466,10 @@
                   "                \"position\": 0,",
                   "                \"schema\": {",
                   "                    \"type\": \"string\",",
-                  "                    \"pattern\": \".*\"",
-                  "                }",
+                  "                    \"pattern\": \"^[a-z0-9].*$\"",
+                  "                }, ",
+                  "                \"description\": \"change_reason\",",
+                  "                \"change_reason\": \"change_reason\"",
                   "            })",
                   "        }",
                   "    };",
@@ -486,7 +528,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"dimension\":\"clientId\",\"position\":1,\"schema\":{\"type\":\"string\",\"pattern\":\"^[a-z0-9].*$\"}}"
+              "raw": "{\"dimension\":\"clientId\",\"position\":1,\"schema\":{\"type\":\"string\",\"pattern\":\"^[a-z0-9].*$\"},\"description\":\"description\",\"change_reason\":\"change_reason\"}"
             },
             "url": {
               "raw": "{{host}}/dimension",
@@ -581,7 +623,9 @@
                   "                \"schema\": {",
                   "                    \"type\": \"string\",",
                   "                    \"pattern\": \".*\"",
-                  "                }",
+                  "                }, ",
+                  "                \"description\": \"description\",",
+                  "                \"change_reason\": \"change_reason\"",
                   "            })",
                   "        }",
                   "    };",
@@ -785,7 +829,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"override\":{\"key1\":\"value2\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"piyaz\"]}}"
+              "raw": "{\"override\":{\"key1\":\"value2\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"piyaz\"]},\"description\":\"description\",\"change_reason\":\"change_reason\"}"
             },
             "url": {
               "raw": "{{host}}/context",
@@ -915,7 +959,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"override\":{\"key1\":\"value3\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"piyaz\"]}}"
+              "raw": "{\"override\":{\"key1\":\"value3\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"piyaz\"]},\"description\":\"description\",\"change_reason\":\"change_reason\"}"
             },
             "url": {
               "raw": "{{host}}/context",
@@ -1050,7 +1094,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"override\":{\"key1\":\"value3\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"tamatar\"]}}"
+              "raw": "{\"override\":{\"key1\":\"value3\"},\"context\":{\"==\":[{\"var\":\"clientId\"},\"tamatar\"]},\"description\":\"description\",\"change_reason\":\"change_reason\"}"
             },
             "url": {
               "raw": "{{host}}/context/move/{{context_id}}",
@@ -1101,6 +1145,8 @@
                   "    delete response.created_by;",
                   "    delete response.last_modified_at;",
                   "    delete response.last_modified_by;",
+                  "    delete response.description;",
+                  "    delete response.change_reason;",
                   "",
                   "    pm.expect(JSON.stringify(response)).to.be.eq(JSON.stringify(expected_context));",
                   "});",
@@ -1213,7 +1259,9 @@
                   "                \"schema\": {",
                   "                    \"type\": \"string\",",
                   "                    \"pattern\": \"^[a-z0-9].*$\"",
-                  "                }",
+                  "                }, ",
+                  "                \"description\": \"description\",           ",
+                  "                \"change_reason\": \"change_reason\"",
                   "            })",
                   "        }",
                   "    };",
@@ -1318,6 +1366,8 @@
                   "const host = pm.variables.get(\"host\");",
                   "const context_id = pm.environment.get(\"context_id\");",
                   "",
+                  "console.log(`context id is thiss : ${context_id}`);",
+                  "",
                   "pm.test(\"204 check\", function() {",
                   "    pm.response.to.have.status(204);",
                   "})",
@@ -1443,6 +1493,8 @@
                   "                \"type\": \"string\"",
                   "            },",
                   "            \"created_by\": \"user@superposition.io\",",
+                  "            \"description\": \"\",",
+                  "            \"change_reason\": \"\"",
                   "        },",
                   "        {",
                   "            \"type_name\": \"Enum\",",
@@ -1451,6 +1503,8 @@
                   "                \"type\": \"string\"",
                   "            },",
                   "            \"created_by\": \"user@superposition.io\",",
+                  "            \"description\": \"\",",
+                  "            \"change_reason\": \"\"",
                   "        },",
                   "        {",
                   "            \"type_name\": \"Boolean\",",
@@ -1458,6 +1512,8 @@
                   "                \"type\": \"boolean\"",
                   "            },",
                   "            \"created_by\": \"user@superposition.io\",",
+                  "            \"description\": \"\",",
+                  "            \"change_reason\": \"\"",
                   "        },",
                   "        {",
                   "            \"type_name\": \"Decimal\",",
@@ -1465,6 +1521,8 @@
                   "                \"type\": \"number\"",
                   "            },",
                   "            \"created_by\": \"user@superposition.io\",",
+                  "            \"description\": \"\",",
+                  "            \"change_reason\": \"\"",
                   "        },",
                   "        {",
                   "            \"type_name\": \"Number\",",
@@ -1472,6 +1530,8 @@
                   "                \"type\": \"integer\"",
                   "            },",
                   "            \"created_by\": \"user@superposition.io\",",
+                  "            \"description\": \"\",",
+                  "            \"change_reason\": \"\"",
                   "        }",
                   "    ]))",
                   "});",
@@ -1620,7 +1680,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"type_schema\":{\"type\":\"number\"},\"type_name\":\"Integer\"}"
+              "raw": "{\"type_schema\":{\"type\":\"number\"},\"type_name\":\"Integer\",\"description\":\"\",\"change_reason\":\"\"}"
             },
             "url": {
               "raw": "{{host}}/types",
@@ -1778,7 +1838,7 @@
                   "language": "json"
                 }
               },
-              "raw": "{\"type_schema\":{\"type\":\"integer\"},\"type_name\":\"Integer\"}"
+              "raw": "{\"type_schema\":{\"type\":\"integer\"},\"type_name\":\"Integer\",\"description\":\"\",\"change_reason\":\"\"}"
             },
             "url": {
               "raw": "{{host}}/types/{{type_name}}",
diff --git a/postman/cac/Context/Create Context/request.json b/postman/cac/Context/Create Context/request.json
index 6bf6048f..1c747552 100644
--- a/postman/cac/Context/Create Context/request.json	
+++ b/postman/cac/Context/Create Context/request.json	
@@ -35,7 +35,9 @@
           },
           "piyaz"
         ]
-      }
+      }, 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/Context/Delete Context/event.test.js b/postman/cac/Context/Delete Context/event.test.js
index 88a601eb..c4de37cb 100644
--- a/postman/cac/Context/Delete Context/event.test.js	
+++ b/postman/cac/Context/Delete Context/event.test.js	
@@ -1,6 +1,8 @@
 const host = pm.variables.get("host");
 const context_id = pm.environment.get("context_id");
 
+console.log(`context id is thiss : ${context_id}`);
+
 pm.test("204 check", function() {
     pm.response.to.have.status(204);
 })
diff --git a/postman/cac/Context/Get Context/event.test.js b/postman/cac/Context/Get Context/event.test.js
index 2a3e2935..1de298d3 100644
--- a/postman/cac/Context/Get Context/event.test.js	
+++ b/postman/cac/Context/Get Context/event.test.js	
@@ -26,6 +26,8 @@ pm.test("Context equality check", function() {
     delete response.created_by;
     delete response.last_modified_at;
     delete response.last_modified_by;
+    delete response.description;
+    delete response.change_reason;
 
     pm.expect(JSON.stringify(response)).to.be.eq(JSON.stringify(expected_context));
 });
diff --git a/postman/cac/Context/Move Context/request.json b/postman/cac/Context/Move Context/request.json
index c19dadef..6f7a06d2 100644
--- a/postman/cac/Context/Move Context/request.json	
+++ b/postman/cac/Context/Move Context/request.json	
@@ -35,7 +35,9 @@
           },
           "tamatar"
         ]
-      }
+      },
+      "description": "description", 
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/Context/Recompute Weight Context/event.prerequest.js b/postman/cac/Context/Recompute Weight Context/event.prerequest.js
index 130f43a5..5b095026 100644
--- a/postman/cac/Context/Recompute Weight Context/event.prerequest.js	
+++ b/postman/cac/Context/Recompute Weight Context/event.prerequest.js	
@@ -16,7 +16,9 @@ function update_dimension_position() {
                 "schema": {
                     "type": "string",
                     "pattern": "^[a-z0-9].*$"
-                }
+                }, 
+                "description": "description",           
+                "change_reason": "change_reason"
             })
         }
     };
diff --git a/postman/cac/Context/Update Context/request.json b/postman/cac/Context/Update Context/request.json
index 8d1043f7..d1bcfdae 100644
--- a/postman/cac/Context/Update Context/request.json	
+++ b/postman/cac/Context/Update Context/request.json	
@@ -35,7 +35,9 @@
           },
           "piyaz"
         ]
-      }
+      }, 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/Default Config/Add default-config key/event.test.js b/postman/cac/Default Config/Add default-config key/event.test.js
index 28b30c2c..3fd5bcad 100644
--- a/postman/cac/Default Config/Add default-config key/event.test.js	
+++ b/postman/cac/Default Config/Add default-config key/event.test.js	
@@ -15,20 +15,60 @@ function getConfigAndTest(key, value) {
             console.log("Failed to fetch config");
             throw error;
         }
-
         const resp_obj = response.json();
         const default_configs = resp_obj.default_configs;
-
+        
+        // Original checks for key-value
         console.log(`Checking if key=${key} with value=${value} in default_configs`);
+        pm.expect(default_configs).to.have.property(key);
         pm.expect(default_configs[key]).to.be.eq(value);
     });
 }
 
+// Original test cases
 pm.test("201 check", function () {
     pm.response.to.have.status(200);
-})
+});
 
 pm.test("Check if key added to default config", function () {
     const key = "key1", value = "value1";
     getConfigAndTest(key, value);
+});
+
+// New test case for description and comment fields
+pm.test("Check if description and comment fields exist", function () {
+    const getRequest = {
+        url: `${host}/config`,
+        method: 'GET',
+        header: {
+            'Content-Type': 'application/json',
+            'x-tenant': 'test',
+        }
+    };
+
+    pm.sendRequest(getRequest, (error, response) => {
+        if(error) {
+            console.log("Failed to fetch config");
+            throw error;
+        }
+        const resp_obj = response.json();
+        console.log("Response:", JSON.stringify(resp_obj, null, 2));
+        
+        // Verify the structure of the response
+        pm.expect(resp_obj).to.have.property('default_configs');
+        const configItem = resp_obj.default_configs.key1;
+        
+        // If the config is returned as an object
+        if (typeof configItem === 'object') {
+            pm.expect(configItem).to.have.property('value');
+            pm.expect(configItem).to.have.property('description');
+            pm.expect(configItem).to.have.property('change_reason');
+        }
+        // If it's just the value directly
+        else {
+            // The original format is maintained
+            pm.expect(resp_obj.default_configs).to.have.property('description');
+            pm.expect(resp_obj.default_configs).to.have.property('change_reason');
+        }
+    });
 });
\ No newline at end of file
diff --git a/postman/cac/Default Config/Add default-config key/request.json b/postman/cac/Default Config/Add default-config key/request.json
index d7dd2e8f..aaa6ab1d 100644
--- a/postman/cac/Default Config/Add default-config key/request.json	
+++ b/postman/cac/Default Config/Add default-config key/request.json	
@@ -30,7 +30,9 @@
       "schema": {
         "type": "string",
         "pattern": ".*"
-      }
+      }, 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/Default Config/Delete default-config key/event.prerequest.js b/postman/cac/Default Config/Delete default-config key/event.prerequest.js
index be764a8e..6fb292cc 100644
--- a/postman/cac/Default Config/Delete default-config key/event.prerequest.js	
+++ b/postman/cac/Default Config/Delete default-config key/event.prerequest.js	
@@ -16,7 +16,9 @@ function add_default_config() {
                 "schema": {
                     "type": "string",
                     "pattern": ".*"
-                }
+                }, 
+                "description": "description",
+                "change_reason": "change_reason"
             })
         }
     };
diff --git a/postman/cac/Dimension/Create Dimension/event.prerequest.js b/postman/cac/Dimension/Create Dimension/event.prerequest.js
index c577e3ee..60df096a 100644
--- a/postman/cac/Dimension/Create Dimension/event.prerequest.js	
+++ b/postman/cac/Dimension/Create Dimension/event.prerequest.js	
@@ -15,8 +15,10 @@ function add_dimension() {
                 "position": 0,
                 "schema": {
                     "type": "string",
-                    "pattern": ".*"
-                }
+                    "pattern": "^[a-z0-9].*$"
+                }, 
+                "description": "change_reason",
+                "change_reason": "change_reason"
             })
         }
     };
diff --git a/postman/cac/Dimension/Create Dimension/request.json b/postman/cac/Dimension/Create Dimension/request.json
index 7fbad8da..ecdf9d53 100644
--- a/postman/cac/Dimension/Create Dimension/request.json	
+++ b/postman/cac/Dimension/Create Dimension/request.json	
@@ -30,7 +30,9 @@
       "schema": {
         "type": "string",
         "pattern": "^[a-z0-9].*$"
-      }
+      }, 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/Dimension/Delete Dimension/event.prerequest.js b/postman/cac/Dimension/Delete Dimension/event.prerequest.js
index 69ca0bd8..a1bd8918 100644
--- a/postman/cac/Dimension/Delete Dimension/event.prerequest.js	
+++ b/postman/cac/Dimension/Delete Dimension/event.prerequest.js	
@@ -16,7 +16,9 @@ function add_dimension() {
                 "schema": {
                     "type": "string",
                     "pattern": ".*"
-                }
+                }, 
+                "description": "description",
+                "change_reason": "change_reason"
             })
         }
     };
diff --git a/postman/cac/Dimension/Update Dimension/request.json b/postman/cac/Dimension/Update Dimension/request.json
index acdfda4a..648f9a9d 100644
--- a/postman/cac/Dimension/Update Dimension/request.json	
+++ b/postman/cac/Dimension/Update Dimension/request.json	
@@ -29,7 +29,9 @@
       "schema": {
         "type": "string",
         "pattern": "^[a-z0-9].*$"
-      }
+      }, 
+      "description": "description", 
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/cac/custom types/Create Type/request.json b/postman/cac/custom types/Create Type/request.json
index 8e0c1ef3..e7f4c557 100644
--- a/postman/cac/custom types/Create Type/request.json	
+++ b/postman/cac/custom types/Create Type/request.json	
@@ -28,7 +28,9 @@
             "type_schema": {
                 "type": "number"
             },
-            "type_name": "Integer"
+            "type_name": "Integer",
+            "description": "",
+            "change_reason": ""
         }
     },
     "url": {
diff --git a/postman/cac/custom types/Get Types/event.test.js b/postman/cac/custom types/Get Types/event.test.js
index f3b58c04..0616edd9 100644
--- a/postman/cac/custom types/Get Types/event.test.js	
+++ b/postman/cac/custom types/Get Types/event.test.js	
@@ -13,6 +13,8 @@ pm.test('expect response be 200', function () {
                 "type": "string"
             },
             "created_by": "user@superposition.io",
+            "description": "",
+            "change_reason": ""
         },
         {
             "type_name": "Enum",
@@ -21,6 +23,8 @@ pm.test('expect response be 200', function () {
                 "type": "string"
             },
             "created_by": "user@superposition.io",
+            "description": "",
+            "change_reason": ""
         },
         {
             "type_name": "Boolean",
@@ -28,6 +32,8 @@ pm.test('expect response be 200', function () {
                 "type": "boolean"
             },
             "created_by": "user@superposition.io",
+            "description": "",
+            "change_reason": ""
         },
         {
             "type_name": "Decimal",
@@ -35,6 +41,8 @@ pm.test('expect response be 200', function () {
                 "type": "number"
             },
             "created_by": "user@superposition.io",
+            "description": "",
+            "change_reason": ""
         },
         {
             "type_name": "Number",
@@ -42,6 +50,8 @@ pm.test('expect response be 200', function () {
                 "type": "integer"
             },
             "created_by": "user@superposition.io",
+            "description": "",
+            "change_reason": ""
         }
     ]))
 });
diff --git a/postman/cac/custom types/Update Type/request.json b/postman/cac/custom types/Update Type/request.json
index 371124a3..b7e373ed 100644
--- a/postman/cac/custom types/Update Type/request.json	
+++ b/postman/cac/custom types/Update Type/request.json	
@@ -28,7 +28,9 @@
             "type_schema": {
                 "type": "integer"
             },
-            "type_name": "Integer"
+            "type_name": "Integer",
+            "description": "",
+            "change_reason": ""
         }
     },
     "url": {
diff --git a/postman/experimentation-platform/Conclude/request.json b/postman/experimentation-platform/Conclude/request.json
index af51941a..6ea2ff47 100644
--- a/postman/experimentation-platform/Conclude/request.json
+++ b/postman/experimentation-platform/Conclude/request.json
@@ -25,7 +25,9 @@
       }
     },
     "raw_json_formatted": {
-      "chosen_variant": "{{experiment_id}}-control"
+      "chosen_variant": "{{experiment_id}}-control", 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/experimentation-platform/Create Experiment 2/event.prerequest.js b/postman/experimentation-platform/Create Experiment 2/event.prerequest.js
index 085ba063..3ece01dc 100644
--- a/postman/experimentation-platform/Create Experiment 2/event.prerequest.js	
+++ b/postman/experimentation-platform/Create Experiment 2/event.prerequest.js	
@@ -24,7 +24,9 @@ function create_default_config_keys() {
                     "schema": {
                         "type": "string",
                         "pattern": ".*"
-                    }
+                    }, 
+                    "description": "description",
+                    "change_reason": "change_reason"
                 })
             }
         };
diff --git a/postman/experimentation-platform/Create Experiment 2/request.json b/postman/experimentation-platform/Create Experiment 2/request.json
index d231f32d..91d33f1e 100644
--- a/postman/experimentation-platform/Create Experiment 2/request.json	
+++ b/postman/experimentation-platform/Create Experiment 2/request.json	
@@ -63,7 +63,9 @@
             "pmTestKey4": "value4-test"
           }
         }
-      ]
+      ], 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/experimentation-platform/Create Experiment/event.prerequest.js b/postman/experimentation-platform/Create Experiment/event.prerequest.js
index a7b3e9ef..1c2fd11f 100644
--- a/postman/experimentation-platform/Create Experiment/event.prerequest.js	
+++ b/postman/experimentation-platform/Create Experiment/event.prerequest.js	
@@ -24,7 +24,9 @@ function create_default_config_keys() {
                     "schema": {
                         "type": "string",
                         "pattern": ".*"
-                    }
+                    }, 
+                    "description": "description",
+                    "change_reason": "change_reason"
                 })
             }
         };
@@ -54,8 +56,10 @@ function create_dimensions(dimension) {
                 "mode": "raw",
                 "raw": JSON.stringify({
                     "dimension": dimension.name,
-                    "position": dimension.position,
-                    "schema": dimension.schema
+                    "priority": dimension.priority,
+                    "schema": dimension.schema, 
+                    "description": dimension.description,
+                    "change_reason": dimension.change_reason
                 })
             }
         };
@@ -73,8 +77,8 @@ function create_dimensions(dimension) {
 create_default_config_keys();
 
 const dimensions = [
-    {name: "os", position: 1, schema: { type: "string", enum: ["android", "ios", "web"] }},
-    {name: "client", position: 2, schema: { type: "string", pattern: ".*" }}
+    {name: "os", position: 1, schema: { type: "string", enum: ["android", "ios", "web"] } , description: "description", change_reason: "change_reason"},
+    {name: "client", position: 2, schema: { type: "string", pattern: ".*" }, description: "description", change_reason: "change_reason"}
 ];
 create_dimensions(dimensions[0]);
 setTimeout(() => {
diff --git a/postman/experimentation-platform/Create Experiment/event.test.js b/postman/experimentation-platform/Create Experiment/event.test.js
index 2acd7253..9e758b59 100644
--- a/postman/experimentation-platform/Create Experiment/event.test.js	
+++ b/postman/experimentation-platform/Create Experiment/event.test.js	
@@ -141,7 +141,9 @@ pm.test("Test created contexts", function() {
                 "pmTestKey1": "value1-control",
                 "pmTestKey2": "value1-control"
             },
-            "variant_type": "CONTROL"
+            "variant_type": "CONTROL", 
+            "description": "description",
+            "change_reason": "change_reason"
         },
         {
             "id": `${experiment_id}-test1`,
@@ -149,7 +151,9 @@ pm.test("Test created contexts", function() {
                 "pmTestKey1": "value2-test",
                 "pmTestKey2": "value2-test"
             },
-            "variant_type": "EXPERIMENTAL"
+            "variant_type": "EXPERIMENTAL",
+            "description": "description",
+            "change_reason": "change_reason"
         }
     ];
     const expected_variant_contexts = [
@@ -181,7 +185,9 @@ pm.test("Test created contexts", function() {
                             }
                         ]
                     }
-                ]
+                ], 
+                "description": "description",
+                "change_reason": "change_reason"
             }
         },
         {
@@ -212,7 +218,9 @@ pm.test("Test created contexts", function() {
                             }
                         ]
                     }
-                ]
+                ], 
+                "description": "description",
+                "change_reason": "change_reason"
             }
         }
     ];
diff --git a/postman/experimentation-platform/Create Experiment/request.json b/postman/experimentation-platform/Create Experiment/request.json
index 030e4c00..a7222cbe 100644
--- a/postman/experimentation-platform/Create Experiment/request.json	
+++ b/postman/experimentation-platform/Create Experiment/request.json	
@@ -68,7 +68,9 @@
             "pmTestKey2": "value2-test"
           }
         }
-      ]
+      ], 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/experimentation-platform/Ramp/request.json b/postman/experimentation-platform/Ramp/request.json
index 9c4e4edc..1985f6e6 100644
--- a/postman/experimentation-platform/Ramp/request.json
+++ b/postman/experimentation-platform/Ramp/request.json
@@ -25,7 +25,9 @@
       }
     },
     "raw_json_formatted": {
-      "traffic_percentage": 46
+      "traffic_percentage": 46, 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {
diff --git a/postman/experimentation-platform/Update Override Keys/event.prerequest.js b/postman/experimentation-platform/Update Override Keys/event.prerequest.js
index a9ad46e7..bffe5d17 100644
--- a/postman/experimentation-platform/Update Override Keys/event.prerequest.js	
+++ b/postman/experimentation-platform/Update Override Keys/event.prerequest.js	
@@ -24,7 +24,9 @@ function create_default_config_keys() {
                     "schema": {
                         "type": "string",
                         "pattern": ".*"
-                    }
+                    }, 
+                    "description": "description",
+                    "change_reason": "change_reason"
                 })
             }
         };
diff --git a/postman/experimentation-platform/Update Override Keys/request.json b/postman/experimentation-platform/Update Override Keys/request.json
index 145614cf..9eba8963 100644
--- a/postman/experimentation-platform/Update Override Keys/request.json	
+++ b/postman/experimentation-platform/Update Override Keys/request.json	
@@ -39,7 +39,9 @@
             "pmTestKey1999": "value-6930-an-test"
           }
         }
-      ]
+      ], 
+      "description": "description",
+      "change_reason": "change_reason"
     }
   },
   "url": {