Marketpath CMS Developer Tutorial Series

Site Settings

Last Updated 3/6/2018

Site settings (properties) help to define a few key and significant facets of your site that improve usability and set it apart from other websites.

The core site settings are

String Site Name {{ site.name }}
Primarily used for display in the management interface, but may also be incorporated in your templates (eg: in your header or footer template)
String Default Domain {{ site.default_domain_name }} (editable through the "Domains" setting)
This is the domain that is used by default when creating new pages on your site. It is also searchable in the site selector to make management of multiple accounts and websites easier.
image Favicon {{ site.settings.favicon }}
This is the file that is returned when a browser requests your favicon (id: /favicon.ico).
stylesheet Editor Stylesheet {{ site.settings.editorStylesheet }}
This is the stylesheet that the WYSIWYG editor uses to display content in the management interface. There are also some cool tricks that you can do with this stylesheet to make styling content in the WYSIWYG editor easier - like define classes that can be used on paragraph tags, anchor tags, spans, and more!
textarea field Default Meta Description {{ site.settings.default_meta_description }}
If a page does not have a defined meta description and the site has a default meta description, the page will use the site's default meta description instead.
text field Default Browser Title Prefix {{ site.settings.browsertitle_prefix }}
If this field is entered, then when a user creates a new page in the UI the value from this field is prefixed to the browser title. Note that this ONLY applies to new pages created in the management interface, and that even then the user creating the page has full control to edit or remove this value. It is not intended to be anything other than a shortcut for content creators.
text field Default Browser Title Suffix {{ site.settings.browsertitle_suffix }}
If this field is entered, then when a user creates a new page in the UI the value from this field is appended to the browser title. Note that this ONLY applies to new pages created in the management interface, and that even then the user creating the page has full control to edit or remove this value. It is not intended to be anything other than a shortcut for content creators.
checkbox field Enable Live Edit Button {{ site.settings.liveedit_enabled }}
When this is enabled, it allows pages on the live site to include an "Edit Page" button when the following conditions are met:
  1. The user is currently editing this site
  2. The user is currently viewing the site over https
  3. The template for the page the user is currently viewing utilizes the {{ header_tags }} liquid markup
Note that after enabling (and publishing) this option, you may need to refresh the management interface in order for the edit link to appear on your live site. After disabling (and publishing) this option, the Edit Page button should go away immediately.
template Default Gallery Template {{ site.settings.default_gallery_template }}
This is simply the gallery template that will be pre-selected by default when a user creates a new gallery on this site. Setting this option both makes creating new galleries one step simpler and increases the likelihood that the majority of galleries will be consistent across the website.

Developers may also add additional custom site settings which, while they cannot affect behavior in the management interface, can be instrumental in making live content consistent and customizable per-site without having to modify the template (eg: Google Analytics code/keys, main menu, footer menu, social options, and more). We will focus on custom site settings in the next lesson.

---- End of Lesson ----

Question? Correction?

Let's work together to make our documentation as helpful as possible.

What is your name? 
What is your email address? 
Feedback: