Skip to content

Commit cfbc5ec

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

File tree

1 file changed

+14
-16
lines changed

1 file changed

+14
-16
lines changed

docs/reference/mapping/removal_of_types.asciidoc

Lines changed: 14 additions & 16 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,30 +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 deprecated. 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 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.
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.
272276

273277
* The `_default_` mapping type is removed.
274278

275279
Elasticsearch 8.x::
276280

277-
* The `type` parameter is no longer supported in URLs.
278-
279-
* The `include_type_name` parameter is deprecated, default to `false` and fails
280-
the request when set to `true`.
281-
282-
Elasticsearch 9.x::
281+
* Specifying types in requests is no longer supported.
283282

284283
* The `include_type_name` parameter is removed.
285284

@@ -423,4 +422,3 @@ POST _reindex
423422
}
424423
----
425424
// NOTCONSOLE
426-

0 commit comments

Comments
 (0)