diff --git a/vllm/config/utils.py b/vllm/config/utils.py
index bd2a741e3..dff9b2c5a 100644
--- a/vllm/config/utils.py
+++ b/vllm/config/utils.py
@@ -355,3 +355,28 @@ class Range:
 
     def __repr__(self) -> str:
         return self.__str__()
+
+
+def handle_deprecated(
+    config: ConfigT,
+    old_name: str,
+    new_name_or_names: str | list[str],
+    removal_version: str,
+) -> None:
+    old_val = getattr(config, old_name)
+    if old_val is None:
+        return
+
+    if isinstance(new_name_or_names, str):
+        new_names = [new_name_or_names]
+    else:
+        new_names = new_name_or_names
+
+    msg = (
+        f"{old_name} is deprecated and will be removed in {removal_version}. "
+        f"Use {', '.join(new_names)} instead."
+    )
+    logger.warning(msg)
+
+    for new_name in new_names:
+        setattr(config, new_name, old_val)