Your achievements

Level 1

0% to

Level 2

Tip /
Sign in

Sign in to Community

to gain points, level up, and earn exciting badges like the new
Bedrock Mission!

Learn more

View all

Sign in to view all badges

Adobe Summit 2023 [19th to 23rd March, Las Vegas and Virtual] | Complete AEM Session & Lab list

AEM 6.3 | Apache Sling Content Disposition Filter | Hosting Static HTML in JCR


Level 2

In AEM 6.2 and 6.3, when we attempt to hit the static content such as (/content/site/static-page.html), it is treated as a binary download and does the same for all other file types(pdf,css, js, images) where response header shows Content-Disposition as an attachment.

In previous versions of AEM (6.1 and below), was there to control response header to render page instead of download. However from 6.2, this component is  deprecated and the reason is Apache Sling Content Disposition Filter( took precedence and an intended change made in product from AEM 6.2 onward and was introduced as part of Sling Security Fix.

Here we have steps to render static pages:

Apache Sling Content Disposition Filter Configuration where static files needs to be added to meet requirements.

Configuration can be reverted back to render static pages without adding it manually in OSGI by uncheck the checkbox(Enable Content Disposition for all paths) and the file would directly open in the browser instead of getting downloaded.

This is how static content can be hosted in JCR and renders in page.


6 Replies


Employee Advisor

There is a reason why this has been implemented that way in the product. It's security.

Of course you can turn it of. You are turning off a security feature of the product. Can you answer the question "are you sure what you are doing, are you aware of consequences and do you accept any negative outcome" with YES? Then go on.



Level 2

I have not asked this as a question, instead posted this in forum.

We are using this as a security feature only.


Employee Advisor

I just wanted to add this as a comment to your tutorial, how to turn this security feature off.

Just in case someone reads it and thinks that this is a good idea without being aware of the consequences 🙂



Level 1

Definitely agreed around a security risk, and should be done on the dispatcher level.

Of course it needs to be documented and treated accordingly with controls.

If you are internal facing with a directory, is there a possibility to disable the filter using a wildcard for a subdirectory, or do you need to explicitly name files?


Level 1

Hi All,

We have the similar issue. We are trying to download the PDf/docx from a AEM community page using File Library component. Wheneven we click on download it shows joson output instead of downloading actual file. It works fine in local host. This is something to do with Dispatcher setting. We have the following filter.  It is still not helping. can someone through a light on this?

<FilesMatch "\.(?i:pdf)|(?i:docx)$">

    ForceType application/octet-stream

    Header set Content-Disposition attachment


Thanks in advance.



Level 3

I came across this old thread. Not sure if you still have this issue with files (I had this issue with PDF's)

Its solved in


I used the "LocationMatch" in httpd.conf and it worked for me.

The ultimate experience is back.

Join us in Vegas to build skills, learn from the world's top brands, and be inspired.

Register Now