Skip to main content Skip to footer

How to edit uSkinned Site Builder appsettings configuration

This guide explains how to view and edit appsettings configuration for uSkinned Site Builder in Umbraco, allowing you to understand and adjust how the package behaves within your site.

On installation of uSkinned Site Builder, a set of settings is added to appsettings. These values represent the default configuration used by uSkinned; if they are removed from the file, the package will automatically continue to use its built-in default settings.

{
    "uSkinned": {
      "SourceCodeOptions": "uSkinned",
      "NotPages": "USNWebsiteConfigurationSection,USNGlobalSettings,USNFooter,USNNavigation,USNStylesFolder,USNStyle,USNBlogAuthor,USNBlogAuthors,USNBlogCategories,USNBlogMonthFolder,USNBlogPostsFolder,USNBlogYearFolder,USNReusablePods,USNReusableComponents,USNComponentGroup,USNPodGroup,USNListingFilters,USNListingFilterGroup,USNListingPagesFolder,USNProductPagesFolder",
      "HideFromPath": "USNListingFilters,USNListingFilterGroup,USNListingPagesFolder,USNBlogCategories,USNBlogPostsFolder,USNProductPagesFolder",
      "WebPEnabled": true,
      "FrontEndImageSizeLimitBytes": 4194304,
      "GoogleFontSource": "fonts.googleapis.com",
      "AllowedContentTemplates": "USNPage,USNListPage,USNListingFilterPage,USNBlogPost,USNBlogCategoryPage,USNProductPage,USNStyle",
      "GenerateDesignFilesOnStartup": false,
      "VisualEditorDisabled": false,
      "HideQuickCreate": false,
      "HideShopCreate": false,
      "HideMultiWebsiteCreate": false,
      "HideThemesAndStarterKits": false,
      "HideHelp": false,
      "HideLicense": false,
      "HideHome": false,
      "MaxStarterKitInstalls": 0
    }      
}

SourceCodeOptions

Defines the front end source code folders available on the Design (node) > Advanced (tab) > Frontend source (field)

See the creating your own codebase guide for further information.

"uSkinned": {
    "SourceCodeOptions": "uSkinned",
  }

NotPages

The 'Links' section and 'Save and preview' option will be hidden on any content nodes that match the Document Type Alias in this list.

"uSkinned": {
    "NotPages": "USNWebsiteConfigurationSection,USNGlobalSettings,USNFooter,USNNavigation,USNStylesFolder,USNStyle,USNBlogAuthor,USNBlogAuthors,USNBlogCategories,USNBlogMonthFolder,USNBlogPostsFolder,USNBlogYearFolder,USNReusablePods,USNReusableComponents,USNComponentGroup,USNPodGroup,USNListingFilters,USNListingFilterGroup,USNListingPagesFolder,USNProductPagesFolder",
  }

HideFromPath

The URL path of a content page will only include pages where the Document Type Alias name is not included in this list.

"uSkinned": {
    "HideFromPath": "USNListingFilters,USNListingFilterGroup,USNListingPagesFolder,USNBlogCategories,USNBlogPostsFolder,USNProductPagesFolder",
  }

WebPEnabled

WebP image compression will be applied to all images unless WebP is specifically disabled on an image type media item.

"WebPEnabled": {
    "SourceCodeOptions": "true",
  }

FrontEndImageSizeLimitBytes

The maximum image size allowed on the frontend of the website in bytes. If this value is exceeded a placeholder image will be displayed stating that the image cannot be displayed.

"uSkinned": {
    "FrontEndImageSizeLimitBytes": 4194304,
  }

GoogleFontSource

The source URL used for Google Fonts. Alternative URLs can be used. 

See the guide on GDPR compliant Google Fonts for further information.

"uSkinned": {
    "GoogleFontSource": "fonts.googleapis.com",
  }

AllowedContentTemplates

uSkinned Site Builder has moved Content Templates to its own section within the Umbraco CMS. Only Document Types in this list can be added to the 'Blueprints' section. 

This section is normally found within the 'Settings' section of Umbraco. The new 'Blueprints' section means you can give normal editors access to this without exposing the 'Settings' section.

"uSkinned": {
    "AllowedContentTemplates": "USNPage,USNListPage,USNListingFilterPage,USNBlogPost,USNBlogCategoryPage,USNProductPage,USNStyle",
  }

GenerateDesignFilesOnStartup

When you click "Save and Publish" on any of your Design nodes, a new CSS stylesheet file (and a JavaScript file, if custom JavaScript has been added) will be created on your web server's file system.

~/wwwroot/uSkinned/css/generated/
~/wwwroot/uSkinned/scripts/generated/

Set this setting to true to generate these files on startup.

"uSkinned": {
    "GenerateDesignFilesOnStartup": "false",
  }

VisualEditorDisabled

Decide if the Visual Editor should be enabled or disabled by default on all Block Lists where the Visual Editor is present.

"uSkinned": {
    "VisualEditorDisabled": "false",
  }

HideQuickCreate

Hide the entire "Quick Create" section from the Content Dashboard.

"uSkinned": {
    "HideQuickCreate": "false",
  }

HideShopCreate

Hide the "Shop" quick create option.

"uSkinned": {
    "HideShopCreate": "false",
  }

HideMultiWebsiteCreate

Hide the "Multi Website" quick create option.

"uSkinned": {
    "HideMultiWebsiteCreate": "false",
  }

HideThemesAndStarterKits

Hide the "Templates" tab from the uSkinned Dashboard.

"uSkinned": {
    "HideThemesAndStarterKits": "false",
  }

HideHelp

Hide the the "Help" tab from the uSkinned Dashboard.

"uSkinned": {
    "HideHelp": "false",
  }

HideLicense

Hide the "License" tab from the uSkinned Dashboard.

"uSkinned": {
    "HideLicense": "false",
  }

HideHome

Hide the "Home" tab from the uSkinned Dashboard.

"uSkinned": {
    "HideLicense": "false",
  }

MaxStarterKitInstalls

The maximum number of Starter Kits that can be installed via the uSkinned Dashboard Templates tab. 0 indicates unlimited.

"uSkinned": {
    "MaxStarterKitInstalls": 0,
  }

BlockCustomViewDataTypes

Comma-separated list of data type names and/or keys (GUIDs) Default: "" (empty)

In the backoffice, uSkinned shows its own preview of blocks, which also gives you the Visual Editor and the Hide from website action. By default this only applies to blocks in the uSkinned block data types (for example USN Block Components, USN Block Pods and USN Block Banner).

Use this setting to give your own Block List or Block Grid data types the same treatment. 

Each entry can be:

  • the data type's name, as it appears under Settings › Data Types. Names are not case-sensitive. A name keeps working if the data type is deleted and recreated with the same name.
  • the data type's key (GUID). Use this if the name might be changed.
"uSkinned": {
    "BlockCustomViewDataTypes": "",
  }

Ready to start your next project?

See why uSkinned Site Builder for Umbraco consistently ranks as the best.


🏆 Voted Best Website Builder on CMS Critic G2: real software reviews.

⭐ ⭐ ⭐ ⭐ ⭐ 4.9 out of 5 on G2 G2: real software reviews.