Skip to content

Commit c9e706e

Browse files
committed
Update 'removal of types' docs to reflect the new plan. (#38548)
1 parent 030bcab commit c9e706e

File tree

1 file changed

+16
-13
lines changed

1 file changed

+16
-13
lines changed

docs/reference/mapping/removal_of_types.asciidoc

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,8 @@
44
IMPORTANT: Indices created in Elasticsearch 6.0.0 or later may only contain a
55
single <<mapping-type,mapping type>>. Indices created in 5.x with multiple
66
mapping types will continue to function as before in Elasticsearch 6.x.
7-
Mapping types will be completely removed in Elasticsearch 7.0.0.
7+
Types will be deprecated in APIs in Elasticsearch 7.0.0, and completely
8+
removed in 8.0.0.
89

910
[float]
1011
=== What are mapping types?
@@ -254,25 +255,28 @@ Elasticsearch 6.x::
254255

255256
* The `_default_` mapping type is deprecated.
256257

258+
* In 6.7, the index creation, index template, and mapping APIs support a query
259+
string parameter (`include_type_name`) which indicates whether requests and
260+
responses should include a type name. It defaults to `true`, and not setting
261+
`include_type_name=false` will result in a deprecation warning. Indices which
262+
don't have an explicit type will use the dummy type name `_doc`.
263+
257264
Elasticsearch 7.x::
258265

259-
* The `type` parameter in URLs are optional. For instance, indexing
260-
a document no longer requires a document `type`.
266+
* Specifying types in requests is deprecated. For instance, indexing a
267+
document no longer requires a document `type`. The new index APIs
268+
are `PUT {index}/_doc/{id}` in case of explicit ids and `POST {index}/_doc`
269+
for auto-generated ids.
261270

262-
* The `GET|PUT _mapping` APIs support a query string parameter
263-
(`include_type_name`) which indicates whether the body should include
264-
a layer for the type name. It defaults to `true`. 7.x indices which
265-
don't have an explicit type will use the dummy type name `_doc`.
271+
* The `include_type_name` parameter in the index creation, index template,
272+
and mapping APIs will default to `false`. Setting the parameter will result
273+
in a deprecation warning.
266274

267275
* The `_default_` mapping type is removed.
268276

269277
Elasticsearch 8.x::
270278

271-
* The `type` parameter is no longer supported in URLs.
272-
273-
* The `include_type_name` parameter defaults to `false`.
274-
275-
Elasticsearch 9.x::
279+
* Specifying types in requests is no longer supported.
276280

277281
* The `include_type_name` parameter is removed.
278282

@@ -416,4 +420,3 @@ POST _reindex
416420
}
417421
----
418422
// NOTCONSOLE
419-

0 commit comments

Comments
 (0)