# Update by query warning in documentations

**URL:** <https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847>\
**Category:** Elasticsearch\
**Created:** [April 27, 2017, 11:26am UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847 "2017-04-27T11:26:17Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![yoav](https://avatars.discourse-cdn.com/v4/letter/y/58f4c7/32.png) [@yoav](https://discuss.elastic.co/u/yoav)\
**Post date:** [April 27, 2017, 11:26am UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/1 "2017-04-27T11:26:17Z")

</div>

Why update-by-query documentations still have a warning saying - "The update-by-query API is new and should still be considered experimental"  
[https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update-by-query.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update-by-query.html)

It was added long ago in 2.3 (Current version is 5.3)  
Is it safe to use in production?

Thanks  
Yoav

---

<div class="post-metadata">

**Author:** ![nik9000](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/nik9000/32/44947_2.png) [@nik9000](https://discuss.elastic.co/u/nik9000)\
**Post date:** [April 27, 2017, 2:21pm UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/2 "2017-04-27T14:21:43Z")

</div>

It's been quite safe since I added it in 2.3. We test it a ton. That tag means that we might change the API in a minor release if we find something crazy. Though, honestly, at this point I think we're beyond that for update-by-query.

---

<div class="post-metadata">

**Author:** ![nik9000](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/nik9000/32/44947_2.png) [@nik9000](https://discuss.elastic.co/u/nik9000)\
**Post date:** [April 27, 2017, 2:27pm UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/3 "2017-04-27T14:27:13Z")

</div>

Actually we'd [meant](https://github.com/elastic/elasticsearch/commit/5fad769ae2d5d652a0a4780d799d86c2faf05429) to unmark it as experimental but we did the java api version of the docs and didn't to the main version. I'll push a fix.

---

<div class="post-metadata">

**Author:** ![nik9000](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/nik9000/32/44947_2.png) [@nik9000](https://discuss.elastic.co/u/nik9000)\
**Post date:** [April 27, 2017, 2:40pm UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/4 "2017-04-27T14:40:50Z")

</div>

I pushed

> <https://github.com/elastic/elasticsearch/commit/72ce9ee126901e4711f9e9d1a2b40784a8500e91>

  
which should cause the experimental tag to be dropped from the documentation in the next half an hour or so.

---

<div class="post-metadata">

**Author:** ![yoav](https://avatars.discourse-cdn.com/v4/letter/y/58f4c7/32.png) [@yoav](https://discuss.elastic.co/u/yoav)\
**Post date:** [April 27, 2017, 5:17pm UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/5 "2017-04-27T17:17:13Z")

</div>

Great. Thank you Nik.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [May 25, 2017, 5:30pm UTC](https://discuss.elastic.co/t/update-by-query-warning-in-documentations/83847/6 "2017-05-25T17:30:07Z")

</div>

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.