Docs
Plugin HubCategoriesTransformationProxy RewriteChangelog

Proxy Rewrite Changelog

Released changes to the Proxy Rewrite plugin (`proxy-rewrite`), newest release first.

29 released changes name proxy-rewrite, newest release first — 20 in Apache APISIX, 9 in API7 Gateway. Each row links to the change itself.

Apache APISIX

ReleaseDateTypeChange
3.18.02026-08-18FixQuery string discarded when use_real_request_uri_unsafe is set
3.18.02026-08-18FeatureSupport multiple same-name headers in headers.add/headers.set
3.8.02024-01-09FixDo not invoke add_header if value resolved as nil in proxy-rewrite plugin
3.5.02023-08-29FeatureSupport regex_uri with unsafe_uri for proxy-rewrite plugin
3.3.02023-04-30FixEnsure proxy-rewrite should set ngx.var.uri
3.3.02023-04-30FeatureSupport variable when rewrite header in proxy-rewrite plugin
3.2.02023-03-06FixThe proxy-rewrite plugin should escape URI parameter parts if they do not come from user config
3.1.02022-12-26FixFix an issue where x-forwarded-host cannot be changed in the proxy-rewrite plugin
3.1.02022-12-26Featureproxy-rewrite plugin supports adding new request headers without overwriting existing request headers with the same name
3.0.0-beta—ChangeThe scheme field has been removed from proxy-rewrite
2.15.02022-07-22FeatureAllow using unescaped raw URL in proxy-rewrite plugin
2.13.02022-03-21FixWhen conf.headers are missing,conf.method can make effect
2.11.02021-11-23FeatureRewrite method
2.3.02021-02-06Featureproxy-rewrite host support host with port
2.2.02021-01-05FeatureSupport var in upstream_uri on proxy-rewrite plugin
2.2.02021-01-05FeatureThe proxy-rewrite plugin support pass nginx variable within header
1.5.02020-08-06ChangeFixed typos in FAQ、admin-api、architecture-design、discovery、prometheus、proxy-rewrite、redirect、http-logger documents. 1916
1.2.02020-04-12FeatureDrop websocket enable control in proxy-rewrite plugin(not backward compatible). 1332
0.9.02019-11-15FeatureProxy Rewrite: Supported remove header feature.
0.8.02019-09-29Featureproxy-rewrite: rewrite uri

API7 Gateway

ReleaseDateTypeChange
3.10.4 (opens in API7 Gateway docs)2026-07-27Featureheaders.set and headers.add now accept an array of values for a single header name, which is sent upstream as separate header lines rather than one comma-joined line. This matters for upstream services that read only… (opens in API7 Gateway docs)
3.10.3 (opens in API7 Gateway docs)2026-07-14FixFixed issue: With use_real_request_uri_unsafe and uri configured together, the request query string was dropped during URI rewriting. The original query string is now preserved and correctly merged when the rewritten… (opens in API7 Gateway docs)
3.9.17 (opens in API7 Gateway docs)2026-07-28Featureheaders.set and headers.add now accept an array of values for a single header name, which is sent upstream as separate header lines rather than one comma-joined line. This matters for upstream services that read only… (opens in API7 Gateway docs)
3.9.16 (opens in API7 Gateway docs)2026-07-10FixFixed issue: With use_real_request_uri_unsafe and uri configured together, the request query string was dropped during URI rewriting. The original query string is now preserved and correctly merged when the rewritten… (opens in API7 Gateway docs)
3.9.9 (opens in API7 Gateway docs)2026-04-10FixFixed issue: The Data Plane compatibility report showed spurious warnings for valid plugin configurations. Plugins using patternProperties, conditional schemas (if/then/else), allOf, dependencies, or additionalPropert… (opens in API7 Gateway docs)
3.5.2 (opens in API7 Gateway docs)2025-02-18FixFixed issue: Version compatibility issue with the plugin. (opens in API7 Gateway docs)
3.5.0 (opens in API7 Gateway docs)2025-01-27FixFixed issue: Incompatibility problems arise from not setting ngx.var.uri. (opens in API7 Gateway docs)
3.5.0 (opens in API7 Gateway docs)2025-01-27FeatureSupported miltiple regex pattern matching. (opens in API7 Gateway docs)
3.5.0 (opens in API7 Gateway docs)2025-01-27FeatureSupported variable when rewrite header. (opens in API7 Gateway docs)

Configuration

Previous Page

Response Rewrite

Next Page