Optionally provide private feedback to help us improve this article...

Thank you for your feedback!


Creating new InstantKB Skins

 This article refers to an older version of InstantKB however the information still applies to newer versions. Wewill be updating this documentation shortly to reflect our newer versions.

To create a new InstantKB skin simply navigate to your InstantKB skins folder. If you've installed locally this is typically "C:\inetput\wwwroot\InstantKB206\Skins\".nstantKB

You should see the default skins provided with InstantKB as sown below…



To create a new skin simply copy the "Classic" skin folder and paste this back into the "Skins" directory as shown below. You can use any of the existing skins as a basis for your new skin allowing you to pick the skin to most closely matches your existing color scheme or layout.

Copy a Provided Skin Folder

Make a copy of one of the provided default skin folders. In this example our new skin will be based off the Classic skin provided with InstantKB so in this instance we'll simply create a copy of the "Classic" Skin Folder...

Rename Your Skin Folder

Provide a unique name for your skin folder. This name is not displayed within InstantKB however it should be unique to ensure you can easily identify your skin...

Update the Skin.xml File

The Skin.xml is required within the root of each skin folder to allow InstantKB to identify available skins. The name you specify within the Skin.xml file will be the name displayed when selecting skins within InstantKB.

You should open the Skin.xml file within NotePad and provide a name for your skin to help identify the skin within InstantKB...



Open Skin.xml and you should see the following XML...

<?xml version="1.0" encoding="UTF-8"?>
<!-- Skin Definition File -->
<!-- If visible is false the skin will only be available to select within the admin area -->
<Skin>
<Detail>
<Name>My Custom Skin</Name>
<Author>Ryan Healey</Author>
<AuthorURL>https://www.instantasp.co.uk/</AuthorURL>
<Visible>true</Visible>
</Detail>
</Skin>

Simply updated the highlighted area to provide a unique name for your cusztom skin. This will be the name displayed within the skin selection drop drop within InstantKB.

Checking InstantKB is aware of your Skin

You should now see your new skin available for selection within InstantKB. To update the skin used by InstantKB you'll need to login as an administrator & access your Admin CP. Click the "Settings" link on the top navigation and click "Gneral". Locate the drop down list of available skins as shown below. Simply select your new skin and save the changes...



We do cache the skins within memory to ensure we don't have to recuse the skins directory on every page request. For this reason if you don't see your skin immediately appear within the forum Admin CP please recycle the application pool used for InstantKB within IIS or make a small change to the Web.config file. This will recucle the web application clearing the ASP.NET cache and forcing InstantKB to scan your skins again.

Customizing your New Skin

Now you know how to create new skins and make InstantKB aware of your custom skin the next step is to start customizing your skin. Customization typically consists of modifying the skin style sheet colors, skin images & skin master page. Please refer to the other sections within the Customization are for assistance.