Toggle menu

Subsite Configuration - Framework Features

A subsite's configuration holds settings that are used across the site. This includes things like the site's title and logo, the theme it uses, PWA settings, Google Analytics tracking IDs, and custom CSS and JavaScript files.

Accessing Subsite Configuration

To access a subsite's configuration, you'll need to be logged into the iCM enterprise URL of your site, which is often https://www.mywebsite.com/enterprise/icm.

Once logged in, navigate to the Definitions section of iCM Management. Open "Subsites" then double click on the name of your site. You'll see "Configuration" as the final tab.

Configuration Tab
 

General Settings

These settings are present in all of the themes.

Look and Feel

PropertyDescription
TitleThe site's title populates the <title> element of the page source. It is also often used in the site footer
ThemeThis drop-down list contains the names of all of the themes installed alongside the site framework. To change a subsite's theme, select a different one form the list. This will reveal a new section of the configuration with theme specific settings. These settings are described in the relevant theme documentation
LocaleThe internationalisation (i18n) locale of this site. For example "en-GB" (British English), "cy" (Welsh), "gd-GB" (Scottish Gaelic), "en-GB-scotland" (Scottish English). Use a country-and-variant-free locale (such as "en" 'International English') unless you intend to distinguish between similar languages at the country or region/community level
Site logoDifferent themes use logos in different ways, but most display an image in their header. Pick the image you would like to use here. Themes will resize the image as appropriate
Favicon and Apple Touch icon

These icons appear in browser tabs and when pages are saved as shortcuts on mobile devices. Site themes will automatically resize these to 32x32 and 152x152

Imports skinIn addition to the standard site skin CSS file, this file is added to the top of the CSS bundle, which means you can use the @import rule to include things like fonts
Site and editor skinsThe core frameworks and themes allow you to apply custom CSS to your subsite that will be bundled up and added to the main CSS. This allows you to override the styles present in the core themes. CSS files are saved as media items, then picked here. There's more information about creating site skins in Custom CSS - Site Skins
Body modifier metadata propertiesWhen values from these metadata properties are related to articles, they will be output as CSS modifiers on the rendered page's <body> tag
Page modified date displayAll articles using the selected templates will display the date on which they were last modified
Article feedbackSee Article Feedback for a full description of these settings
In this Section - Show on templatesThe templates you pick here may display an "In this Section" panel. This panel displays sibling articles (ie articles at the same level in the article tree) of the article that's being viewed. See Related Assets for more information
In this Section - MetadataPick one or more metadata values. These values can be related to any article to hide the "In this Section" panel

Articles

PropertyDescription
Home pageSelect the homepage article of your site. This is the page a user will reach when they navigate to the site's domain without any other path in the URL
LoginWhen a user tries to access secure content on your site, this is the article they will be redirected to. This article should use the Authentication template
SearchThis article is used to display search results. It should use the Search template
Cookie policyThis article should use the Cookie Policy template. It provides content for the banner and sets cookie preferences
Page not found, Security denied, Resource goneThese three articles provide page content when a user encounters an error on your site. The relevant 404 or 410 response is returned to the browser, but the page content can be content managed. These articles can use any template type, so you could use a Search template as your 404 page. If blank sensible defaults are provided. These articles are best located in a "hidden" area of the site, without any sibling articles or navigation

Miscellaneous

PropertyDescription
Custom JavaScriptCustom scripts can be added to your site in a similar way to skins. Upload .js files into the iCM media library, then select them here. Take great care using custom JavaScript. Elements in the DOM will change with new releases of the site frameworks and themes
Render related templatesSome templates have special "related" views that mean, when articles using them are related to other articles, they output content in a special panel rather than simply a link in the "related articles" panel. The templates that have this functionality should be picked here to enable it
Default from addressWhen emails are sent by your site, and the "from" address can't be determined, this value will be used. This is most commonly used for error emails sent to site administrators.

This address is also used if you enable two-factor authentication in the iCMSiteUser provider for website logins
Responsive image media component listEnter the name of the image component that should be used in responsive images. This should be the name of the largest, best quality image. In the majority of cases this doesn't need to be set and the best image will be used automatically, but if you have upgraded from and old framework, or are having problems with 1:1 ratio images, this setting will help
Security
Public userUsers who are not logged into your site will appear as an "anonymous user". Select the user you would like to use here. This user should not have any user profile information or be in any security groups other than a dedicated "public only" group. There's a "note on the anonymous user" in the Securing Content article
Session cookie domainsA comma separated list of domains to use for writing session cookies. This allows subsites on a common domain to share their session
Content Security Policy - Allow FramingA delimited (whitespace, comma) list of domains that are allowed to frame this site. These appear as sources in the site's CSP frame-ancestors (opens new window) header.

The current domain will always be added by default when enabled, any invalid domains will be ignored. All URL's must be absolute and wildcards are allowed within parts of the URL (eg https://*.example.com). Take care using wildcards as you could risk allowing framing from more origins than intended
Metadata and SEO
Title format

The format of the title that is output in the page source, tokens are substituted for real values when the page is rendered. The default is [articleheading] - [subsitename]. Allowed tokens are:

  • [articleheading] - The article heading
  • [subsitetitle] - The title set in the subsite configuration
  • [subsitename] - The name set in the subsite properties
Document Section title format

The format of the [articleheading] token (see above) for articles using the Document Section template. If left blank, the article heading will be used. You can also include the title of the parent document. The available tokens are:

  • [sectionheading] - The heading of the Document Section article
  • [documentheading] - The heading of the Document article
Forms Service title format

The format of the [articleheading] token (see above) and the page <h1> for articles using the Forms Service template. If left blank, the article heading will be used. The available tokens are:

  • [articletitle] - The article heading
  • [formpagetitle] - The title of the current page of the form, as set in the forms designer. If the page doesn't have a title, nothing is displayed

This feature is designed to allow multi-page forms to have unique <h1> page titles. All forms on your site will be affected by this setting

MetadataMetadata values from these properties can be related to an article and will be output in the head of the page source
Twitter card sizePick between between content="summary" and content="summary_large_image"
Robots.txtEnter the content of your site's robots.txt file here. If left blank all crawlers will be disallowed.

To allow all crawlers to crawl all pages of your site, enter:
Robots.txt
 
For a full description of how robots.txt files work see www.robotstxt.org (opens new window)

You can also add robots meta tags to individual articles using iCM metadata. See Metadata Properties, Unfurling and Structured Data Markup
Progressive Web App
Progressive Web App settingsSee Progressive Web App (PWA) for a full description of these settings
Google Keys
Google Keys and IDsThese are IDs from your Google tools and products, output into the source code of each page of this subsite. See below for more information

Google Services

Analytics

This is the GA4 Measurement ID from Google Analytics which starts "G-". When you set up Google Analytics, you'll find this ID in the "Data Streams" section of the admin pages.

Here's the ID for this site:

Stream Details
 

There's a summary of setting up analytics in the Google Analytics 4 article.

Tag Manager

This is the "Container ID" from Google Tag Manager. It's displayed on the main account page when you log into Tag Manager.

Google Tag Manager Container ID
 

Google's documentation is at https://support.google.com/tagmanager (opens new window)

If you are using Tag Manager to inject analytics into your site, you should also add the GA4 measurement ID above - our cookie banner needs this so that cookies can be blocked until consent is given.

Maps

The location fields in forms and the maps on our Event and Location templates use Google Maps. For these maps to work correctly on your site, you'll need an appropriate API key or (for premium account holders) a registered Client ID from Google.

Google have a guide to getting a key in their https://developers.google.com/maps/documentation/javascript/get-api-key (opens new window) documentation. It will guide you through creating a project and selecting appropriate API keys.

The main console for managing APIs is https://console.cloud.google.com/google/maps-apis (opens new window). The APIs you'll need for most things on your site are the "Maps JavaScript API" and "Geocoding API". You can see the actual key by clicking on the API name, then on "Credentials".

We strongly recommend following Google's advice and restricting your API keys. This is done from the "Credentials" tab. Click on the name of the key, then select "HTTP referrers" and enter a list of the sites allowed to use this key. For example, the key used on our documentation sites is restricted to:

Google Maps API Key Restrictions
 

Theme Settings

The theme specific section will change depending upon the theme you select for your subsite. You'll find information about these settings in the Themes documentation:

Last modified on October 16, 2024

Share this page

Facebook icon Twitter icon email icon

Print

print icon