Skip to content

Commit 59e7d20

Browse files
committed
Update 'removal of types' docs to reflect the new plan. (#38548)
1 parent 1bf9000 commit 59e7d20

File tree

1 file changed

+14
-13
lines changed

1 file changed

+14
-13
lines changed

docs/reference/mapping/removal_of_types.asciidoc

Lines changed: 14 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?
@@ -256,27 +257,28 @@ Elasticsearch 6.x::
256257

257258
* The `_default_` mapping type is deprecated.
258259

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

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

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`.
273+
* The `include_type_name` parameter in the index creation, index template,
274+
and mapping APIs will default to `false`. Setting the parameter will result
275+
in a deprecation warning.
270276

271277
* The `_default_` mapping type is removed.
272278

273279
Elasticsearch 8.x::
274280

275-
* The `type` parameter is no longer supported in URLs.
276-
277-
* The `include_type_name` parameter defaults to `false`.
278-
279-
Elasticsearch 9.x::
281+
* Specifying types in requests is no longer supported.
280282

281283
* The `include_type_name` parameter is removed.
282284

@@ -420,4 +422,3 @@ POST _reindex
420422
}
421423
----
422424
// NOTCONSOLE
423-

0 commit comments

Comments
 (0)