From 0f67dcb98cc08b8b41948e5e031a001f5c0898aa Mon Sep 17 00:00:00 2001
From: Ivan Despot <66276597+g-despot@users.noreply.github.com>
Date: Mon, 1 Dec 2025 13:39:00 +0100
Subject: [PATCH] Update README

---
 README.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d25f5bdcf..824fa0dfc 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,21 @@
 
 A Java native client for Weaviate.
 
-## Usage
+## ⚠️ New Java client version ⚠️
 
-To start using Weaviate Java client add this dependency to `pom.xml`:
+The **Weaviate Java Client v6** is now available and should be used for all new projects:
+
+- **[Switch to v6 branch](https://github.com/weaviate/java-client/tree/v6)** 
+
+**The v5 client is now deprecated** and will not receive updates for new Weaviate features. We strongly recommend migrating to v6 to access the latest capabilities and improvements.
+
+---
+
+## Usage (v5 - Deprecated)
+
+> **Note:** The information below is for the deprecated v5 client. Please use v6 for new projects.
+
+To start using Weaviate Java client v5, add this dependency to `pom.xml`:
 
 ```xml