Upgrading to newer version of Enterprise Portal "breaks" HTML in Site page

02-08-2021 03:19 PM
MVP Regular Contributor


Our organization just pushed an update of our Enterprise portal from version 10.6.1 to 10.8.1. I've created an Enterprise Site that uses custom HTML and CSS for the homepage, based off of bootstrap. It worked and displayed perfectly before the upgrade, but now things are no longer displaying properly and the upgrade appears to have "broken" the HTML.

Does anyone know if there are compatibility differences (perhaps regarding the version of bootstrap) between these versions of Enterprise or any other changes I should be aware of?

Thank you!

0 Kudos
4 Replies
Esri Contributor

Hi Katherine,

maybe too simple a question, but was your application built using http addresses for the service(s) it accesses?

At 10.8.x https only is the default configuration for ArcGIS Enterprise (Portal and Server)

this can be updated in admin configuration, see 




but, if the services are secured, it is recommended that you really should amend your web maps and applications to use encrypted communications to protect login credentials.

MVP Regular Contributor

Hi David,

Yes everything is using https. I don't think that's related to the issue here. What I'm experiencing is a layout issue. I had a grid set up with different icons I created to link to different parts of the site, but now they don't line up the same way they used to, and some of the HTML is now just displaying as text, like this:



0 Kudos
Esri Contributor

Hi @Katherine_Clark,

I don't know where you edited your home page either in the index.html directly or the Home Page Tab in portal, I know the location has changed of the index.html between 10.6.1 and 10.8.1 the current location is here, this file was probably changed during the upgrade and any JS does not get moves to the new location.

"C:\Program Files\ArcGIS\Portal\framework\webapps\arcgis#home\index.html"


If you edited the Home Page Tab then just try to re-apply the html the footer tick also gets turned of  during upgrade if I recall correctly.

Have a look at these two locations under the Home Page Tab 









0 Kudos
MVP Regular Contributor

Hi @HenryLindemann and @DavidHoy ,

I determined that the issue is due to the fact that version 10.8 no longer accepts the "class" attribute of div tags in HTML.  

Supported HTML in 10.8:


Supported HTML in 10.6 (the version we were using): 



I built my page using the bootstrap grid system, and even in bootstrap 5 it appears to still use the container, row, and col classes. https://getbootstrap.com/docs/5.0/layout/grid/ 



Is it not possible to use bootstrap like this anymore for site pages? Why would Esri deprecate the div tag in this way?