IIS Mod-Rewrite documentation
Overview Documentation    Quick overview    Rewrite directives    Support directives    Extended directives       X-PrgRestart       X-PrgEngine       X-TxtWatchChanges       X-AddOriginalURL       X-OriginalURLHeader       X-ProxyConnTimeout       X-ProxyRespTimeout       X-ProxyKeepHost       X-VirtualDirWalk       X-UseUTF8Encoding    Control center    Apache compatibility Download Purchase FAQ  
IIS Mod-Rewrite - URL rewrite tool for IIS

X-UseUTF8Encoding Directive

X-UseUTF8Encoding is an extended engine setting directive that controls whether IIS should force UTF-8 or ASCII encoding when it maps the requested url to a physical file. Normally, you should have UTF-8 encoding on, but in rare cases you may need to turn this option off in order to prevent compatibility with Apache mod_rewrite for some improperly encoded URLs.

This directive overrides the default engine setting "Use UTF-8 encoded file mapping" in Engine Settings page.

This directive is supported only by IIS Mod-Rewrite Pro.

IMPORANT: This directive is IIS Mod-Rewrite specific. It is not compatible with Apache mod_rewrite and it should be removed from the rewrite configuration when migrating from IIS to Apache.

Configuration context
  • per-server configurations
  • per-virtual-host configurations

X-UseUTF8Encoding (on|enable|yes|true) | (off|disable|no|false)

It requires only one argument. Specify either of on|enable|yes|true to force UTF-8 encoding for URL to physical file mapping, or specify either of off|disable|no|false to force ASCII encoding using the server's default codepage.

X-UseUTF8Encoding can be used only once within the same configuration scope.

Download and try
IIS Mod-Rewrite

IIS rewrite

Download IIS Mod-Rewrite

Purchase IIS Mod-Rewrite