Show Page Sections

Heretto Deploy Portal at a Glance

Heretto Deploy Portal enables you to instantaneously deliver content from Heretto CCMS to a customizable and dynamic portal.

Figure 1. Content in Heretto CCMS is published to Heretto Deploy Portal
Your content in Heretto CCMS is instantaneously published to Heretto Deploy Portal.

Features and Benefits

With Heretto Deploy Portal, you can:

  • Instantaneously deliver your content to a modern, responsive, and lightweight documentation portal or your own endpoint
  • Maintain large sets of versioned content (50,000+ topics)
  • Leverage strong SEO performance
  • Personalize content based on your audience

Structured and Faceted Search

The Heretto Deploy search engine is built on Lucene and enables you to leverage full text, fuzzy matching, and weighted search capabilities within your Heretto Deploy Portal. You can also use your custom-built CCMS taxonomy metadata to add search facets in the portal so users can refine their search results.

User Authentication and Content Filtering

Heretto Deploy enables you to specify different access levels on your Heretto Deploy Portal by using the Single Sign On (SSO) feature and DITAVALs to identify who the user is and what content they should have access to. This way, your users are identified, authenticated, and delivered only the specific, relevant content to individual users.

Heretto Deploy lets you to filter your portal content by associating a DITAVAL with a sitemap. This enables you to quickly do the following:
  • Hide internal content from your public portal
  • Filter content by properties like language, region, or product
  • Filter content by version or release

Customizable Look and Feel

The Heretto Deploy Portal look and feel is customizable to match your brand, typography, and style guidelines. Customizing and configuring your portal can be done directly in Heretto CCMS and enables a seamless integration with your other web properties.

Code Formatting

The Heretto Deploy Portal can automatically format code and highlight the code syntax in <codeblock> and <pre> elements. In the DITA source, you can specify the language type for each <codeblock> or <pre> element individually.

Introduction to Creating Portals

To help you get started quickly, this section introduces the key basics that are necessary knowledge before you begin building your Heretto Deploy Portal.

Getting Started: Essential Concepts and Tasks Involved

First consider what a user would see when they log in and what you want them to see. The structure of your portal can be a gateway that brings together diverse information, or one that enables personalized access to services based on the user's role within the organization. The design elements of your portal should therefore reflect your content strategy, brand, and be tailored to your target audiences.

Next, you will need some sample content. We recommend incorporating images and videos in your sample content, along with common DITA elements that your team will regularly use when creating content. This enables you to see how these will render in the portal.

Now you are ready to sign into your Heretto CCMS account, upload your sample content, and start creating your portal.

Note: Your Customer Success Manager (CSM) will provide you with access to portal environments for development work.

Necessary Developer Skills

HTML (HyperText Markup Language)

You must be familiar with HTML basics. HTML is the most standard markup language for creating web pages. Familiarity with HTML is needed for constructing web pages with unique (and advanced) features and functions.

XML (Extensible Markup Language)

XML will be required for portal development. XML will be needed to create the documents that will be shared via the portal.

CSS (Cascading Style Sheet)

CSS adds style to your web pages. You will need to be familiar with CSS to give your portal a unique look, including layout and design. CSS is also used to ensure that your portal will properly appear on different devices and screen sizes.

JSON (JavaScript Object Notation)

JSON is used to send information from the Heretto CCMS to a portal page. To customize your portal, you will need to work with the JSON format.

If you are looking to take advantage of personalization features, you will need to set up authentication. The portal supports single sign-on (SSO). Developing an SSO solution requires knowledge of:

  • OAuth 2.0

  • OpenID

  • JWT

To learn more, refer to: Heretto Deploy Portal SSO - Introduction

Portal Development Using Heretto CCMS

The Heretto CCMS Source Editor enables you to navigate through and edit the code for portal development. Alternatively, you can use any code editor you prefer and upload the edited source files into Heretto CCMS.

The Heretto CCMS Source Editor enables you to:

  • Edit the map XML source

  • Edit the topic XML source side-by-side with the user-friendly editor

  • Edit the Markdown, CSS, and JSON code

  • Find and replace, collapse and expand XML code

Other Source Editor features in Heretto CCMS include:

  • Detection and flagging for invalid code

  • Suggestions for and automatic closure of XML elements

For comprehensive instructions on editing code directly in Heretto CCMS, refer to the Source Editor Overview.

About Environments for Hosting Images

When customizing the portal design to reflect a company brand, adding custom logos and images will be necessary.

You will need to host these images in a separate environment. Contact your IT team will have these assets available and stored in an environment that your team will have access to, such as a GitHub repository.

For more information, refer to Adding your Logo, Favicon, or Banner

Scope of Supported Customizations

What’s possible with the Heretto Deploy Portal?

Look and feel:

  • Images

  • Typography

  • Color palette

  • Layouts

Portal functionality:

  • Define search facets

  • Define localized text

  • Access control

  • Personalization

  • Feature configuration

Use the list below to help you plan for portal customizations and create a satisfactory user experience, control languages, and ensure that visitors can easily access the information they need.

Table 1. Heretto Deploy Portal: Available Customizations

What You Can Customize


  • Table of Contents (TOC)

  • Site sections

  • Sitemap configuration

  • Permalinks

  • Link redirects

  • Sharing option


  • Cascading Style Sheet (CSS) rendering order

  • Stylesheets and CSS classes

  • Fonts

  • Images

  • Default icons

  • Output classes

  • Favicon

  • Footer

  • Text strings

Site settings

  • Cache expiration period

  • HTML description for the site

  • Search Engine Optimization (SEO) crawling and keywords

  • Domain name

  • Environment variables

  • Manifest

Content Discovery

  • Custom search facets

  • Indexed searches for specific audiences


  • Define User Groups

  • OpenID Connect Authentication


  • Google Tag Manager

  • Google Analytics

Translation support

  • Portal content can be localized

  • Portal interface can be localized

Planning Your Heretto Deploy Portal

​Building a portal requires the combined efforts of content creators, developers, and business leaders. To help you develop and customize a portal to suit the specific needs of your organization, our Heretto team has created this step-by-step plan to help you succeed on your portal-build journey.

Planning Process

The Heretto team recommends following a planning process like the one below when you're making design decisions about your portal. Here are some steps we recommend for planning an effective and successful project:


Identify your audiences and your content delivery goals for your Heretto Deploy Portal. To ensure that the final outcome meets your expectations and requirements, we recommend building a list of high level requirements that your content team shares with your development team.


This involves designing the portal. Using this documentation to determine what's possible, we recommend making wireframe diagrams of the portal based on your needs. Both the content and development teams will need to work together to implement these wireframe designs because the content and page layout are dependent on the content structure.


Based on your brand guidelines and supplied brand assets, we will work with your marketing department to access the brand book, and assets such as logos and images. Have your web designers add custom styling to reflect the brand identify of your organization.

Visual Design

Using the wireframes and your portal development environment, create a prototype of the portal. This can be shared with your team for comments, suggestions, and feedback.

Design System

Build a set of sample pages that conveys the site's default DITA element styling. Using your sample content, the portal will present typography samples, list types, note types, table formatting, task formatting and code blocks.

Portal Development

At this stage, begin building the navigation system, authentication, and search configuration. Update logos, footers and any other portal page elements.

Content Integration

With the portal development complete, integrate it with your production content. This will expose any additional tasks needed to create the ideal experience. When this is complete, share this within your organization or even with your partners and customers for feedback.

QA and Testing

The final stage in the process involves a test of the portal with your content to verify that the everything runs as planned and is ready to launch. This will help all stakeholders to understand any errors. For this stage, we recommend having all the customizations and configurations pushed up to the staging environment.


When you are ready for a production launch, work with your Customer Success Manager to coordinate a DNS cutover. This will enable the portal to be accessed by users on your web domain.

Developer Support

Our Heretto support team is available to assist you during the Heretto Deploy Portal development. In order to streamline the process, we request that you identify a lead contact on your team who will oversee the project.

Assigning a Development Lead

Organizations that opt to manage their own portal customizations need to designate a Development Lead who will act as the point of contact for both your team and the Heretto team during your portal implementation. That point of contact should manage all inquiries from within your organization and submit support requests for assistance.

The Development Lead can submit requests to our Support Portal in these ways:

CSM involvement

Your Customer Success Manager (CSM) can also assist you during the development of your portal.

In most cases, the CSM will direct you to submit a request to the support team. However, your CSM may be able to offer some advice and share general tips and recommendations on how to approach your Heretto Deploy Portal development project or point you to available resources.