# Source of Truth for Possible Field Mapping

**URL:** <https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206>\
**Category:** Elasticsearch\
**Created:** [June 18, 2016, 9:06am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206 "2016-06-18T09:06:37Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![KodrAus](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/kodraus/32/22798_2.png) [@KodrAus](https://discuss.elastic.co/u/KodrAus)\
**Post date:** [June 18, 2016, 9:06am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/1 "2016-06-18T09:06:37Z")

</div>

So I'm just wondering if the docs can be totally trusted as a complete source of truth for all possible field mapping properties on a data type.

I'm not much of a Java dev, but if pointed in the right direction I could probably grok the source. I've noticed the .NET client has slightly different fields than the docs, some of which are deprecated, some of which just don't seem to be mentioned anywhere.

I ask so that I can make sure I'm supporting mapping properly in my Rust client.

---

<div class="post-metadata">

**Author:** ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)\
**Post date:** [June 18, 2016, 9:26am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/2 "2016-06-18T09:26:47Z")

</div>

Can you point out some discrepancies?

---

<div class="post-metadata">

**Author:** ![KodrAus](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/kodraus/32/22798_2.png) [@KodrAus](https://discuss.elastic.co/u/KodrAus)\
**Post date:** [June 18, 2016, 12:45pm UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/3 "2016-06-18T12:45:17Z")

</div>

Sure, so for example `numeric_resolution` on `date`, which isn't in the [docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/date.html#date-params) (I think because it's deprecated?), but is in the [.NET client](https://github.com/elastic/elasticsearch-net/blob/master/src/Nest/Mapping/Types/Core/Date/DateProperty.cs#L31) (for back-compat?).

And `fielddata` (in the pre 5.x format) isn't listed on a bunch of fields in the [docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/number.html#number-params) (to keep the docs concise?), but is in the [.NET client](https://github.com/elastic/elasticsearch-net/blob/master/src/Nest/Mapping/Types/Core/Number/NumberProperty.cs#L31).

One last one is `ignore_malformed` on `geo_point` which is in the [docs](https://www.elastic.co/guide/en/elasticsearch/reference/master/geo-point.html#geo-point-params), but not in the [.NET client](https://github.com/elastic/elasticsearch-net/blob/master/src/Nest/Mapping/Types/Geo/GeoPoint/GeoPointProperty.cs#L22) (although it does have `validate`, which I think might have been changed to `ignore_malformed` for consistency at some point?).

I'm sure there are perfectly sane reasons for differences, but it'd be great if there was somewhere I could go with everything that is current for the upcoming `5.x` I could use as a base.

I've gone spelunking in the [Java source](https://github.com/elastic/elasticsearch/tree/master/core/src/main/java/org/elasticsearch/index/mapper/core) a few times, but couldn't be totally sure of what I was looking at 😄

---

<div class="post-metadata">

**Author:** ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)\
**Post date:** [June 18, 2016, 9:22pm UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/4 "2016-06-18T21:22:02Z")

</div>

I'll see if I can ask the .Net team to comment 🙂

---

<div class="post-metadata">

**Author:** ![KodrAus](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/kodraus/32/22798_2.png) [@KodrAus](https://discuss.elastic.co/u/KodrAus)\
**Post date:** [June 18, 2016, 11:36pm UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/5 "2016-06-18T23:36:54Z")

</div>

That'd be awesome, thanks! 🙂

I'm just trying to sort out what's still around for backwards compatibility but deprecated and what's current.

Since I'm starting greenfield I don't have any legacy APIs to maintain so don't need to include stuff that's being phased out.

---

<div class="post-metadata">

**Author:** ![forloop](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/forloop/32/9021_2.png) [@forloop](https://discuss.elastic.co/u/forloop)\
**Post date:** [June 21, 2016, 1:51am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/6 "2016-06-21T01:51:19Z")

</div>

The [`master` branch](https://github.com/elastic/elasticsearch-net/commits/master) and the resulting [`master` documentation](https://www.elastic.co/guide/en/elasticsearch/client/net-api/master/index.html) should be considered a _work in progress_ at this time; it's being actively worked on in line with changes happening with the 5.x alpha releases of Elasticsearch.

For example, [`ignore_malformed` is now on relevant geo queries](https://github.com/elastic/elasticsearch-net/commit/cf66fe08991dbf4b2546c987ecfe029c9cc464a9). It looks like the fielddata change hasn't yet gone in, but we're looking at the mappings this week. If you do come across anything that you think looks like a discrepancy (even if it turns out not to be), [please feel free to open an issue](https://github.com/elastic/elasticsearch-net/issues), would be greatly appreciated 🙂

Anything in NEST that is deprecated in Elasticsearch should be marked with `[Obsolete]` in the source.

---

<div class="post-metadata">

**Author:** ![KodrAus](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/kodraus/32/22798_2.png) [@KodrAus](https://discuss.elastic.co/u/KodrAus)\
**Post date:** [June 21, 2016, 2:15am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/7 "2016-06-21T02:15:07Z")

</div>

Thanks @forloop

I think I'll keep my stuff in its current form then and comb through the .NET client once ES 5.x hits GA.

I'll open issues for anything I can dig up 🙂 How do you guys keep up with what's correct for mappings?

---

<div class="post-metadata">

**Author:** ![forloop](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/forloop/32/9021_2.png) [@forloop](https://discuss.elastic.co/u/forloop)\
**Post date:** [June 21, 2016, 4:32am UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/8 "2016-06-21T04:32:22Z")

</div>

Thanks 👍

> [@KodrAus](#):
>
> How do you guys keep up with what's correct for mappings?

Internal comms, [release notes](https://www.elastic.co/guide/en/elasticsearch/reference/master/es-release-notes.html), commits, issues and PRs 😄

---

<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:** [July 5, 2017, 10:41pm UTC](https://discuss.elastic.co/t/source-of-truth-for-possible-field-mapping/53206/9 "2017-07-05T22:41:57Z")

</div>


