Customize the way your Service Portal home page content is organized using the simple layout builder in HappyFox Service Desk. You can add custom widgets, show/hide default widgets and customize their appearance to keep your customers engaged with rich, helpful content. 

Required Permission

Customize look and feel of Service Portal pages

• This is a Account level Permission
• Only users with this permission will be able to customize the Service Portal Home page.
• You can enable these permissions by navigating to Main Menu > Manage > Roles and Permissions > Role Type: Account > Service Portal section.

How to customize the Service Portal Home Page in Service Desk?

1. Navigate to Main Menu > Service Portal > Look and Feel sub module.
2. Click on Home from the list of pages available for customization.
3. You can customize the various Layout options on the right sidebar with relevant configurations. More details on the layout options are explained below.
4. Use the toggle inside layout options to show/hide the widget.
5. Click Add to add custom layout options components to your home page.
6. Click Reorder to reorder the positions of various layout options components.
7. Click Save to save the current configuration as a draft. The changes saved will now reflect on the inbuilt site preview.
8. Click Publish to confirm your changes made to your Service Portal Home page.

Home Page - Layout Options

Click on Customize to edit the layout options of your Service Portal Home Page.

Announcement

• This dismissable component lets you highlight key announcements in your service portal.
• If enabled, the announcement bar is visible across all pages of your service portal.
• You can specify the colors and text for announcement section inside the layout options.

Header

• This component lets you customize the header of your service portal.
• Changes made to the header will reflect correspondingly in all pages of your service portal.
• Colors: Lets you specify the background and text color for your service portal header.

• Logo: Lets you upload a logo for your service portal header in PNG/JPG/BMP format.

  • Logos with dimensions larger than 210*38 will be shrunk to fit.

  • You can also make the service portal logo clickable by adding a URL inside Logo links to field.

• Mobile Logo: Lets you upload a mobile logo for your service portal header in PNG/JPG/BMP format.

  • Logo with dimensions larger than 38*38 will be shrunk to fit.

  • Specify a name for your service portal in the Service Portal Name field. This name would appear adjacent to the logo inside the header. Popular examples are "Help Center" and "Service Portal".

• You can add a maximum of 6 links in your header. The texts and URL for each of these links can be configured.

• You can also choose to make the header sticky as you scroll down the service portal pages.

Banner

• This component lets you customize the colors, images, and texts of your home page banner.
• You could add a lively banner image to your home page with the built-in image uploader.
  • The height of the home page banner is 420 pixels.
  • Please upload a PNG/JPG/BMP image with resolution greater than 1280*420 and use the built-in re-sizer to fit.
  • Use the Overlay Opacity to add a layer of transparency to your banner image.
  • Also, you could specify a background color to your banner that matches your brand colors.
• Specify the heading text and its color. The heading text is present prominently in the center of your banner.
• Additionally, choose to enable search bar to your home page banner. The search bar lets you quickly search for articles and forum posts.

Custom Text Area

• Custom text areas can be used to add texts and images specific to the service portal home page.
• Use the built-in rich text editor to customize the content present inside the custom text area.
• Visibility of custom text areas can be configured depending on the login state of the end-user.

Top Articles

• Top Articles lists the most viewed articles in your knowledge base.
• You can choose to list a maximum of 15 articles in this section, sorted by most viewed to least by default.

Top Sections

• Top Sections lists all the top-level sections in your knowledge base.
• Choose the format of how you would like to display the Top Sections on the service portal home page using the drop-down Section template:
  • Description
  • Articles
  • Subsections

Footer

• This component lets you customize the footer band of your service portal.
• Note: Changes made to the footer will reflect correspondingly in all pages in your service portal.
• You can choose to add Footer Text and toggle its visibility.
• You can add a maximum of 5 links in your footer. The texts and URL for each of these links can be configured.

How to add a new custom layout component in Home Page?

• Click Add adjacent to Layout options and choose a custom component to add to your Service Portal Home page.

Here are the different types of components you could add to your home page:

1. Featured Articles:

• Featured articles component is used to feature specific external knowledge base articles on your service portal home page.
• You can specify the background color and title text for this component.
• Note: a maximum of 12 external articles can be featured at a time. If you would like to showcase more articles, it is recommended to create another featured articles component.

2. Featured Sections:

• Featured section component is used to selectively feature specific knowledge base sections on your service portal home page.
• You can specify the background color, text colors, button color and title text for this component.
• Choose the format of how you would like to display the Featured Sections on the service portal home page using the drop-down
• Section template:
  • Description
  • Image and description
  • Articles
  • Image and articles
  • Subsections
  • Image and subsections
• Note: A maximum of 12 sections can be featured at a time. If you would like to showcase more sections, it is recommended to create another featured sections component.
• You could also toggle ON/OFF the visibility of a button "Browse all sections". Clicking this button would redirect you to the "All Sections" page.

3. Custom Text Areas:

You can add Multiple custom text areas to your service portal. Each custom text area component is numbered with #1, #2 for reference.

Reordering layout options components:

Click Reorder adjacent to Layout options and specify the display order for your service portal home page components:

• The announcement, header, banner, and footer cannot be re-ordered and they always take their respective positions.
• Other default components like top sections along with custom components (If enabled) can be re-ordered. Click and drag the component above or below another component for re-ordering. Changes made to the order are saved to draft in real-time.
• Home page display order:
  • Announcement (If enabled)
  • Header
  • Banner (If enabled)
  • {{Reorderable components}}
  • Footer

Frequently Asked Questions

1) How do I customize other home page related pages like All Sections password, request new account pages, etc.?

A: At the moment it is not possible to customize other home page related pages. The colors and styles specified in the home page will be applied correspondingly in all home page related pages. For example, the title highlight inside the section details page will have the same background color as the home page banner.

2) Can I restore home page draft to the last published version?

A: Yes. Look out for Restore link towards the bottom of the layout options sidebar. Click Reset to undo all the draft changes made after last publish activity on the home page.

3) I always get redirected to the Login page when I visit the home page. Why?

A: This scenario could be possible due to multiple reasons:

• There are no external articles present in your knowledge base.
• The service portal visibility preference Allow contacts to view KB without logging in is set to true.