Receive Product Updates In Your Inbox

Desk Jekyll Helpdesk Theme

Table of contents


Install the dependencies with Bundler:

bundle install

Run the following to generate your site:

bundle exec jekyll serve

You can find more on Deployment Methods page on Jekyll website.

Build process

Install UIkit font end framework dependency via Npm:

npm install

Enable live browser reload with the following:

bundle exec jekyll s --livereload

Use the following commands to compile js scripts:

npm run dev

Compile and minify:

npm run build


To modify the primary color, open /assets/css/main.scss and replace the #d40c3c color value:

// Primary template color
$global-primary-background: #d40c3c;

Further style customisation can be done in the following files:


Site and author details

Add your site and author details in _config.yml:

# Site title and description
title:              Desk - Helpdesk Jekyll Theme
description:        Knowledge base Jekyll theme.

# Site base hostname & protocol, e.g.
url:                ""

# Site logo, image or text
  image:          logo.png # e.g. logo.png, upload logo image file to /assets/img/ folder
  text:           Desk      # if the above "logo:" image variable  is not set, this text logo is displayed instead

# Author settings
  name:           John Smith

# Social share buttons
twitter_username:   username
github_username:    username

Update favicon

You can find the current favicon (favicon.png) inside the theme /uploads/ directory, just replace it with your new favicon.

Set in the main navigation links in _data/navigation_header.yml:

  - title: About
    url: /about/

Home Page

To create a home page, just create a file inside the root directory. The following is a YAML Front Matter example for a page:

layout: help
title: How Can We Help You?
subtitle: Self Help Support
  background: "#ffffff"   # background color, note setting a background image below will overlay the background color
  image: ocean.jpg        # local image e.g ocean.jpg from /assets/posts/ folder or remote e.g
  align: top              # header image alignment e.g. top, center or bottom
  text: dark              # text color e.g. dark or light
  search: true            # enable search
  columns: 3              # number of category columns; 1, 2, 3, 4
  title: Featured Articles
  tag: featured           # tag used to populate featured section on home page

Home page category boxes are added in _data/navigation_categories.yml, e.g.:

- heading: Browse All Topics
    - title: Getting Started
      desc: Get your account up and running in just few easy steps
      icon: settings

    - title: Account and Billing
      desc: Managing your account, creating new users and exporting data
      icon: credit-card


To create a faq page, just create a new page inside the root directory and add the following code in content:

{% include faqs.html %}

Next create faq post entries in _faqs folder, similar to creating posts.


To keep things more organized, add post images to /assets/posts/ directory, and add theme images to /assets/img/ directory.

To add an image to a post or page use the following codes: Local image from /assets/posts/ directory:

{% include image.html img="girl.jpg" alt="Alt for image" caption="Girl on a rock" %}

External wide image with lightbox:

{% include image.html img="" lightbox="true" alt="Alt for image" caption="Image in lightbox" %}

Adding table of contents to a post

Add the following code at the top of the post:

#### Sections in this article

{:.no_toc} exludes #### Sections in this article title from indexing in table of contents.

Google Anaytics

To enable Google Anaytics, add the following lines to your Jekyll site:

  google_analytics: UA-NNNNNNNN-N

Google Analytics will only appear in production, i.e., JEKYLL_ENV=production

Disqus Comments

Optionally, if you have a Disqus account, you can tell Jekyll to use it to show a comments section below each post. To enable it, add the following lines to your Jekyll site:

    shortname: my_disqus_shortname

You can find out more about Disqus’ shortnames here.

Comments are enabled by default and will only appear in production, i.e., JEKYLL_ENV=production. If you don’t want to display comments for a particular post you can disable them by adding comments: false to that post’s YAML Front Matter.



Customer support is provided through our Envato item support tab for up to six months from the purchase date and is provided Monday to Friday during the business week. We aim to answer all support requests daily, most are handled within 24h.

Please note items downloaded from Envato Elements are not supported so you will be unable to get assistance with technical questions, installation, third-party assets or direct guidance.

Before contacting support please:

  • Read this documentation
  • Describe your problem in detail
  • Include links
  • Attach screenshot

Need More Help?

Receive Product Updates In Your Inbox