# Docs on ansible.builtin.urlencode mangled?

**URL:** <https://forum.ansible.com/t/docs-on-ansible-builtin-urlencode-mangled/44594>\
**Category:** Get Help\
**Created:** [October 1, 2025, 8:54am UTC](https://forum.ansible.com/t/docs-on-ansible-builtin-urlencode-mangled/44594 "2025-10-01T08:54:29Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![dnmvisser](https://avatars.discourse-cdn.com/v4/letter/d/8e8cbc/32.png) [@dnmvisser](https://forum.ansible.com/u/dnmvisser)\
**Post date:** [October 1, 2025, 8:54am UTC](https://forum.ansible.com/t/docs-on-ansible-builtin-urlencode-mangled/44594/1 "2025-10-01T08:54:29Z")

</div>

Hi, as it me or is [ansible.builtin.urlencode filter – Quote data for use in a URL path or query using UTF-8. — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/urlencode_filter.html) a bit mangled?

Its neighbour at [ansible.builtin.urldecode filter – Decode percent-encoded sequences — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/urldecode_filter.html) does look OK…

---

<div class="post-metadata">

**Author:** ![jborean](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/jborean/32/1525_2.png) [@jborean](https://forum.ansible.com/u/jborean)\
**Post date:** [October 1, 2025, 10:27am UTC](https://forum.ansible.com/t/docs-on-ansible-builtin-urlencode-mangled/44594/2 "2025-10-01T10:27:58Z")

</div>

Looks like `urldecode` is an actual filter provided by Ansible whereas `urlencode` is just one shadowed by Ansible from the builtin filters from Jinja. There was some work to try and automatically document the shadowed filters that Ansible doesn’t ship but does expose with doc links to the Jinja2 docs and seems like it might need a bit of TLC.

Edit: Looks like it was my PR that was implemented here but with some extra changes on top while I was away [doc - Dynamically document jinja builtins by jborean93 · Pull Request #85215 · ansible/ansible · GitHub](https://github.com/ansible/ansible/pull/85215).
