Skip to content

Update to httpCompression attributes #273

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Apr 3, 2025
Merged

Update to httpCompression attributes #273

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
17c4e8a
Update to httpCompression attributes
remcoeissing Nov 19, 2018
e0fe4fd
Update compression settings description for IIS versions
Rick-Anderson Apr 1, 2025
af79e34
Apply suggestions from code review
Rick-Anderson Apr 2, 2025
5fead6c
Update ms.date in httpCompression index.md
wadepickett Apr 2, 2025
57ea2ea
Revert Update ms.date in httpCompression index.md
wadepickett Apr 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions iis/configuration/system.webServer/httpCompression/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -181,6 +181,8 @@ HTTP compression is usually available on the default installation of IIS 7 and l

### Attributes

These attributes can only be configured at server level. Configuration at a site level or lower will be ignored.

| Attribute | Description |
| --- | --- |
| `cacheControlHeader` | Optional string attribute. <br><br>Specifies the directive that IIS adds to the Cache-Control header that overrides the HTTP Expires header. This attribute ensures that older clients and proxy servers do not attempt to cache compressed files. To enable this setting, you must set the **sendCacheHeaders** attribute to **true**. The WWW service must be restarted before changes to this property take effect. <br><br>The default value is `max-age=86400`. |
Expand All @@ -204,9 +206,9 @@ HTTP compression is usually available on the default installation of IIS 7 and l

| Element | Description |
| --- | --- |
| [`scheme`](scheme.md) | Optional element. <br><br>Specifies the compression scheme (Gzip or Deflate) IIS uses to compress client requests. |
| [`dynamicTypes`](dynamictypes/index.md) | Optional element. <br><br>Specifies configuration settings for dynamic compression. |
| [`staticTypes`](statictypes/index.md) | Optional element. <br><br>Specifies configuration settings for static compression. |
| [`scheme`](scheme.md) | Optional element. <br><br>Specifies the compression scheme (Gzip or Deflate) IIS uses to compress client requests. This element can only be configured at server level. |
| [`dynamicTypes`](dynamictypes/index.md) | Optional element. <br><br>Specifies configuration settings for dynamic compression. For IIS 10.0 and later, can only be configured at the site level. Versions prior to IIS 10.0, can only be configured at the server level. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this sentence "For IIS 10.0 and later, can only be configured at the site level. Versions prior to IIS 10.0, can only be configured at the server level" indicates that dynamicTypes settings cannot be used at server level on IIS 10+. That's not correct and even default IIS 10 configuration file contains dynamicTypes at server level.

I suggest we change it to "For IIS versions prior to IIS 10.0, can only be configured at the server level. For IIS 10.0 and later, can also be configured at the site level."

| [`staticTypes`](statictypes/index.md) | Optional element. <br><br>Specifies configuration settings for static compression. For IIS 10.0 and later, can only be configured at the site level. Versions prior to IIS 10.0, can only be configured at the server level. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similarly, here we should say "For IIS versions prior to IIS 10.0, can only be configured at the server level. For IIS 10.0 and later, can also be configured at the site level."


### Configuration Sample

Expand Down