Skip to content

Commit 6e62b48

Browse files
authored
Update plan for the removal of mapping types. (#29586)
8.x will no longer allow types in APIs and 7.x will issue deprecation warnings when `include_type_name` is set to `false`.
1 parent 124fecd commit 6e62b48

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

docs/reference/mapping/removal_of_types.asciidoc

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -258,23 +258,26 @@ Elasticsearch 6.x::
258258

259259
Elasticsearch 7.x::
260260

261-
* The `type` parameter in URLs are optional. For instance, indexing
261+
* The `type` parameter in URLs are deprecated. For instance, indexing
262262
a document no longer requires a document `type`. The new index APIs
263263
are `PUT {index}/_doc/{id}` in case of explicit ids and `POST {index}/_doc`
264264
for auto-generated ids.
265265

266-
* The `GET|PUT _mapping` APIs support a query string parameter
267-
(`include_type_name`) which indicates whether the body should include
268-
a layer for the type name. It defaults to `true`. 7.x indices which
269-
don't have an explicit type will use the dummy type name `_doc`.
266+
* The index creation, `GET|PUT _mapping` and document APIs support a query
267+
string parameter (`include_type_name`) which indicates whether requests and
268+
responses should include a type name. It defaults to `true`.
269+
7.x indices which don't have an explicit type will use the dummy type name
270+
`_doc`. Not setting `include_type_name=false` will result in a deprecation
271+
warning.
270272

271273
* The `_default_` mapping type is removed.
272274

273275
Elasticsearch 8.x::
274276

275277
* The `type` parameter is no longer supported in URLs.
276278

277-
* The `include_type_name` parameter defaults to `false`.
279+
* The `include_type_name` parameter is deprecated, default to `false` and fails
280+
the request when set to `true`.
278281

279282
Elasticsearch 9.x::
280283

0 commit comments

Comments
 (0)