diff --git a/src/vs/vscode.d.ts b/src/vs/vscode.d.ts
index 352ad0b7974..c9e929e212f 100644
--- a/src/vs/vscode.d.ts
+++ b/src/vs/vscode.d.ts
@@ -1906,6 +1906,9 @@ declare namespace vscode {
 		 * An [edit](#TextEdit) which is applied to a document when selecting
 		 * this completion. When an edit is provided the value of
 		 * [insertText](#CompletionItem.insertText) is ignored.
+		 *
+		 * The [range](#Range) of the edit must be single-line and one the same
+		 * line completions where [requested](#CompletionItemProvider.provideCompletionItems) at.
 		 */
 		textEdit: TextEdit;