# Documentation generation - enums

**URL:** <https://community.postman.com/t/documentation-generation-enums/19361>\
**Category:** Help Hub\
**Created:** [January 20, 2021, 9:18pm UTC](https://community.postman.com/t/documentation-generation-enums/19361 "2021-01-20T21:18:54Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![xavier\_h](https://avatars.discourse-cdn.com/v4/letter/x/a8b319/32.png) [@xavier\_h](https://community.postman.com/u/xavier_h)\
**Post date:** [January 20, 2021, 9:18pm UTC](https://community.postman.com/t/documentation-generation-enums/19361/1 "2021-01-20T21:18:55Z")

</div>

Does the postman documentation generator display enums and descriptions? I don’t see that happening when I publish documentation. Using OpenAPI 3.0 YAML schema.

Thanks.

---

<div class="post-metadata">

**Author:** ![taehoshino](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/taehoshino/32/6608_2.png) [@taehoshino](https://community.postman.com/u/taehoshino)\
**Post date:** [January 21, 2021, 12:44am UTC](https://community.postman.com/t/documentation-generation-enums/19361/2 "2021-01-21T00:44:33Z")

</div>

Hi @xavier_h! Welcome to the community 👋

Currently, optional parameters are not documented. However, there’s a feature request on a similar topic:

> <https://github.com/postmanlabs/postman-app-support/issues/2847>
>
> Postman Version: 4.10.3 (4.10.3)
> App (Chrome app or Mac app): Mac app
> OS details: 10.12.3 (16D32)
> Is the Interceptor on and enabled in the...

Please feel free to share your use case to weigh in. Our product managers use that feedback to prioritize and add items to our development roadmap 😉

---

<div class="post-metadata">

**Author:** ![omarkhazamov](https://avatars.discourse-cdn.com/v4/letter/o/8797f3/32.png) [@omarkhazamov](https://community.postman.com/u/omarkhazamov)\
**Post date:** [May 5, 2022, 3:39pm UTC](https://community.postman.com/t/documentation-generation-enums/19361/3 "2022-05-05T15:39:00Z")

</div>

I think his question is more like How do I get “enum”:’[val1,val2,val3] from the swagger JSON into a documentation? Currently documentation will only show “enum”: type or “enum”: example instead of enumerating all possible values

How that makes sense.

---

<div class="post-metadata">

**Author:** ![aerospace-explorer-6](https://avatars.discourse-cdn.com/v4/letter/a/439d5e/32.png) [@aerospace-explorer-6](https://community.postman.com/u/aerospace-explorer-6)\
**Post date:** [September 21, 2022, 6:17am UTC](https://community.postman.com/t/documentation-generation-enums/19361/4 "2022-09-21T06:17:57Z")

</div>

@omarkhazamov Yes, exact my requirement. Do we have any fix for it?