diff --git a/CHANGELOG.md b/CHANGELOG.md
index f7a0c9b128d23..c8da7bc557661 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,11 +6,16 @@
 
 Breaking Changes:
 
-- <a name="1_4_0_replace_json">[json]</a> replaced `@theia/json` Theia extension with `vscode.json-language-features` VS Code extension [#7972](https://github.com/eclipse-theia/theia/pull/7972)
+<a name="1_4_0_replace_json"></a>
+- [[json]](#1_4_0_replace_json) replaced `@theia/json` Theia extension with `vscode.json-language-features` VS Code extension [#8112](https://github.com/eclipse-theia/theia/pull/8112)
   - You can register JSON validations at application startup by implementing `JsonSchemaContribution` Theia contribution point.
   - Alternatively you can provide JSON validations using VS Code [contributes.jsonValidation](https://code.visualstudio.com/api/references/contribution-points#contributes.jsonValidation) contribution point.
-- <a name="1_4_0_absolute_user_storage_uri">[user-storage]</a> settings URI must be an absolute to satisfy expectations of `vscode.json-language-features` [#7972](https://github.com/eclipse-theia/theia/pull/7972)
+<a name="1_4_0_absolute_user_storage_uri"></a>
+- [[user-storage]](#1_4_0_absolute_user_storage_uri) settings URI must be an absolute to satisfy expectations of `vscode.json-language-features` [#8112](https://github.com/eclipse-theia/theia/pull/8112)
   - If you imlpement a custom user storage make sure to check old relaitve locations, otherwise it can cause user data loss.
+<a name="1_4_0_deprecate_languages"></a>
+- [[languages]](#1_4_0_deprecate_languages) `@theia/languages` extension is deprecated, use VS Code extensions to provide language smartness: 
+  https://code.visualstudio.com/api/language-extensions/language-server-extension-guide [#8112](https://github.com/eclipse-theia/theia/pull/8112)
 
 ## v1.3.0
 
diff --git a/packages/languages/README.md b/packages/languages/README.md
index 7112ccbe0804c..ac10bca06c7d8 100644
--- a/packages/languages/README.md
+++ b/packages/languages/README.md
@@ -1,3 +1,5 @@
+> Deprecated since 1.4.0 - use VS Code extensions to contribute language smartness: https://code.visualstudio.com/api/language-extensions/language-server-extension-guide
+
 <div align='center'>
 
 <br />
diff --git a/packages/languages/src/browser/language-client-contribution.ts b/packages/languages/src/browser/language-client-contribution.ts
index 04d5b9c56152f..ebfca25892e5a 100644
--- a/packages/languages/src/browser/language-client-contribution.ts
+++ b/packages/languages/src/browser/language-client-contribution.ts
@@ -31,6 +31,10 @@ import { WorkspaceService } from '@theia/workspace/lib/browser';
 import { InitializeParams } from 'monaco-languageclient';
 import { Deferred } from '@theia/core/lib/common/promise-util';
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness:
+ * https://code.visualstudio.com/api/language-extensions/language-server-extension-guide
+ */
 export const LanguageClientContribution = Symbol('LanguageClientContribution');
 export interface LanguageClientContribution extends LanguageContribution {
     readonly running: boolean;
@@ -41,6 +45,10 @@ export interface LanguageClientContribution extends LanguageContribution {
     restart(): void;
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness:
+ * https://code.visualstudio.com/api/language-extensions/language-server-extension-guide
+ */
 @injectable()
 export abstract class BaseLanguageClientContribution implements LanguageClientContribution {
 
diff --git a/packages/languages/src/node/language-server-contribution.ts b/packages/languages/src/node/language-server-contribution.ts
index 728f90fc34985..325362d0f7916 100644
--- a/packages/languages/src/node/language-server-contribution.ts
+++ b/packages/languages/src/node/language-server-contribution.ts
@@ -42,11 +42,19 @@ export interface LanguageServerStartOptions {
     parameters?: any
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness:
+ * https://code.visualstudio.com/api/language-extensions/language-server-extension-guide
+ */
 export const LanguageServerContribution = Symbol('LanguageServerContribution');
 export interface LanguageServerContribution extends LanguageContribution {
     start(clientConnection: IConnection, options: LanguageServerStartOptions): MaybePromise<void>;
 }
 
+/**
+ * @deprecated since 1.4.0 - use VS Code extensions to contribute language smartness:
+ * https://code.visualstudio.com/api/language-extensions/language-server-extension-guide
+ */
 @injectable()
 export abstract class BaseLanguageServerContribution implements LanguageServerContribution {