Frequently Asked Questions

Knowledge Base Fundamentals

What is a knowledge base?

A knowledge base is an online library of information designed to preserve institutional knowledge about various topics relating to a company or organization. It centralizes important information, making workflows more efficient, increasing transparency, and providing a record of changes over time. Knowledge bases can be internal (for employees) or external (for customers and users). [Source]

What is the difference between an internal and external knowledge base?

An internal knowledge base is created for use within an organization, storing resources like company policies, meeting logs, and departmental information. It helps teams stay connected and work efficiently. An external knowledge base is customer- or user-facing, providing information such as product guides, FAQs, troubleshooting, and best practices. External knowledge bases empower users to solve problems independently and reduce support requests. [Source]

What are the benefits of having a knowledge base?

Knowledge bases help avoid content silos, provide more consistent service, and build standardized processes. For internal use, they enable efficient onboarding, quick access to information, and cross-departmental transparency. For external use, they empower customers to self-serve, reduce support requests, and help build a consistent brand experience. [Source]

What types of content should be included in a knowledge base?

Knowledge bases can include project starters, how-to demos, video demonstrations, glossaries, feature descriptions, best practices, forums, FAQs, and troubleshooting guides. Mixing content types helps engage different users and supports a variety of learning preferences. [Source]

How should a knowledge base be structured for maximum effectiveness?

Effective knowledge bases are well-organized, searchable, and structured by audience (internal or external). They should have a consistent article format, clear navigation, and a robust search function. Regular updates and feedback loops help keep content relevant and useful. [Source]

Hygraph for Knowledge Bases & Content Management

Should I use a headless CMS like Hygraph for knowledge bases and portals?

Yes, a headless CMS like Hygraph allows you to structure and deliver content across devices and platforms. Hygraph supports publishing, asset management, structured content, workflows, and a user-friendly interface, making it simple to create and manage knowledge bases and portals. [Source]

What features does Hygraph offer for building knowledge bases?

Hygraph provides a GraphQL-native architecture, content federation, scalability, and a user-friendly interface. It supports integrations with tools for localization, digital asset management, personalization, and more. These features help teams create, manage, and distribute knowledge efficiently. [Source]

Does Hygraph support integrations with other tools?

Yes, Hygraph offers a wide range of integrations, including Netlify, Vercel, BigCommerce, Shopify, Lokalise, AWS S3, Cloudinary, Mux, Ninetailed, and more. These integrations support hosting, eCommerce, localization, digital asset management, personalization, and AI capabilities. [Source]

Does Hygraph provide an API for managing knowledge base content?

Yes, Hygraph provides a powerful GraphQL API that allows you to fetch and manage content efficiently, making it ideal for dynamic knowledge bases and portals. [Source]

How does Hygraph ensure the security and compliance of knowledge base data?

Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant. It offers enterprise-grade security features such as SSO integrations, audit logs, encryption at rest and in transit, and sandbox environments to protect sensitive data and meet regulatory standards. [Source]

How easy is it to get started with Hygraph for building a knowledge base?

Hygraph is designed for ease of use, with an intuitive interface praised by customers for being accessible to both technical and non-technical users. You can sign up for a free-forever account and access comprehensive documentation, video tutorials, and onboarding guides to get started quickly. [Source]

Use Cases & Customer Success

Who can benefit from using Hygraph for knowledge bases?

Hygraph is ideal for developers, IT decision-makers, content creators, project managers, agencies, and enterprises looking to modernize their tech stack, scale across geographies, or improve development velocity. It is used across industries such as food and beverage, consumer electronics, automotive, healthcare, travel, media, eCommerce, SaaS, marketplaces, education technology, and wellness. [Source]

What are some real-world examples of companies using Hygraph?

Notable customers include Sennheiser, HolidayCheck, Ancestry, Samsung, Dr. Oetker, Epic Games, Bandai Namco, Gamescom, Leo Vegas, and Clayton Homes. For example, Komax achieved a 3X faster time to market, Autoweb saw a 20% increase in website monetization, and Samsung improved customer engagement with a scalable platform. [Source]

What business impact can customers expect from using Hygraph?

Customers can expect time savings through streamlined workflows, faster speed-to-market, improved customer experience, and lower operational costs. These benefits help businesses modernize their tech stack and achieve operational efficiency. [Source]

What are some common pain points Hygraph solves for knowledge management?

Hygraph addresses operational pains (reliance on developers, outdated tech stacks, conflicting global team needs), financial pains (high operational costs, slow speed-to-market, expensive maintenance, scalability challenges), and technical pains (boilerplate code, overwhelming queries, evolving schemas, cache and integration issues). [Source]

How does Hygraph differentiate itself from other CMS solutions for knowledge bases?

Hygraph stands out with its GraphQL-native architecture, content federation, and scalability. It empowers non-technical users, modernizes legacy systems, ensures consistent branding across regions, and streamlines development workflows. These features help reduce costs, accelerate speed-to-market, and support business growth. [Source]

Pricing & Getting Started

What is Hygraph's pricing model?

Hygraph offers a free forever Hobby plan, a Growth plan starting at $199/month, and custom Enterprise plans. For more details, visit the pricing page.

How easy is it to implement Hygraph for a knowledge base?

Hygraph is designed for quick implementation. For example, Top Villas launched a new project in just 2 months. Customers can get started by signing up for a free account and using onboarding resources. [Source]

Support & Documentation

What support and training does Hygraph offer?

Hygraph provides 24/7 support via chat, email, and phone. Enterprise customers receive dedicated onboarding and expert guidance. All users have access to detailed documentation, video tutorials, and a community Slack channel. [Source]

Where can I find technical documentation for Hygraph?

Comprehensive technical documentation is available at Hygraph Documentation, covering everything needed to build and deploy projects.

Performance & Security

How does Hygraph optimize content delivery performance?

Hygraph emphasizes optimized content delivery performance, ensuring rapid content distribution and responsiveness. This helps reduce bounce rates, increase conversions, and improve user experience and search engine rankings. [Source]

What security certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant, ensuring high levels of data protection and security. [Source]

Webinar Event: How to Avoid Personalization Tech Traps

What is a Knowledge Base?

A knowledge base is an online library of information to preserve institutional knowledge about various topics relating to a company or organization.
Emily Nielsen

Written by Emily 

Mar 09, 2021
Mobile image

A knowledge base is an online library of information to preserve institutional knowledge about various topics relating to a company or organization.

Instead of information being scattered around across various services, a knowledge base ensures that the most important information is housed in a single place. Knowledge bases increase transparency, make workflows more efficient, and preserve a record of changes over time. There are two types of knowledge bases - internal and external. This guide will examine what exactly a knowledge base is and what its benefits are.

#Internal Knowledge Base

An internal knowledge base, as the name implies, is a resource that is created for internal use within an organization. Information stored within an internal knowledge base can range from company policies to a log of meetings, information for shared use, and even can be broken down by department.

Internal knowledge bases empower people to keep track of information in a more public setting so that team members can always return to the resource. By keeping all of the information in a single place, team members are more likely to make use of the tool and will have an easier time referring back to information. Internal knowledge bases are essential for teams to stay connected and work efficiently. By documenting everything in a shared space, it ensures no team member is left behind and that all information is communicated properly.

To keep knowledge bases from becoming completely unusable, it is important to create structure and organization so that the resources can be properly utilized. Implementing a search function is also critical. Without a search function, it is unlikely that team members will gain any expected value.

The uses for an internal knowledge base can vary by team but at the end of the day, knowledge bases, when done well, are the organized source of truth for information about the department or organization at large.

Here are some use cases broken down by department:

Sales: Workflows, Scripts and Templates, Demo guidelines and examples, Meeting minutes, Department Policies, Case Studies

Marketing: PR materials, Assets, Content Backlog, Campaign tracking, Style Guide

Development: QA standards, Descriptions of features in development, Roadmap, Troubleshooting

HR: Onboarding information, Company policies, Contact information, Company hierarchy

#External Knowledge Base

External knowledge bases provide a similar treasure trove of information however it is intended to be customer or user-facing - and can be publicly accessible or protected behind authentication.

External knowledge bases are the first place users should look when seeking information on the product, best practices, troubleshooting or FAQs. Teams have different ways of approaching external knowledge bases (sometimes called content hubs) depending on their specific use case. In the world of sophisticated digital products, knowledge bases can be an essential tool to provide users with a great user experience 24/7. Instead of calling in every support request or requiring extensive onboarding, knowledge bases can give people the chance to address their questions or curiosities independently via your content first. Some knowledge bases include troubleshooting forums which give teams a detailed log of how other people have approached a problem. This can be particularly helpful with microservices or technical products.


Knowledge bases can include more than just text content. They can also include how-to videos, project starters, or audio files where relevant. Creating a mixture of content will help engage different types of users or encourage them to interact in new ways with the product. By creating a single content repository, users can become familiar with the best practices for a product. Buying into the language, jargon, and assumptions that come with using a new product becomes more approachable when new users have the opportunity to get acquainted at their own pace.


Good things to include in an external knowledge base are:

  • Project starters
  • How-to demos
  • Video demonstrations or explanations
  • Glossaries
  • Feature descriptions
  • Best practices
  • Forums
  • FAQs
  • Troubleshooting guides

#What Purpose do they Serve?

#Internal Knowledge Base

Internal knowledge bases serve as an information-rich database for employees to reference throughout their work. Whether it be a way to store all of the supplemental resources, such as case studies, how-to-guides, and reference pieces, or used to create a history of how projects, processes, approaches evolve over time, internal knowledge bases can be crucial in creating a highly productive team.

Knowledge bases help new employees get up to speed quickly and give them all of the necessary resources to succeed without the arduous task of tracking down various team members and waiting for them to provide you with the information you need. They build a strong foundation for the entire team and allow other departments to have a quick snapshot of processes, projects, and output. Information sharing is essential for teams working to build a consistent, successful brand. Although the use cases of knowledge bases may vary slightly from department to department, using a single tool across departments increases accessibility and usability across the entire company.

Internal knowledge bases should reflect the uses and needs of the team as a whole. Creating a record of projects and processes is essential to a highly productive team.

#External Knowledge Base

External knowledge bases should become the automatic first reference point for customers with a question. Because all of the information on how to use a product, case studies, references, FAQs, can be found in a single place, users know it is a good place to start to find the answer.

External knowledge bases serve as a way to provide high-quality customer service to those who are on smaller-scale projects and do not have support SLAs. This relieves some of the stress on the support team and gives them more capacity to address more complex support problems. By managing what information customers receive and how it is framed, it can also help create a well-rounded consistent brand that is known for providing high-quality information to its user base. External knowledge bases should serve as a content hub for all of the relevant information for working with a digital tool. They should consider the various stakeholders which interact with the tool and make sure that they can serve as a trusted resource along with the various steps of working with a tool.


#What are the benefits of a knowledge base?

#Internal Knowledge bases

Avoid content Silos

Knowledge bases bolster team members to be independent, work efficiently and find answers easily, rather than needing to wait for replies from others which can slow down progress. Knowledge bases serve as a treasure trove of information that can help new team members onboard quickly and ensure that they are providing the same high-quality service or output as their more experienced counterparts. They reduce the number of content silos and avoid the team’s output existing in a vacuum. If the Sales team is curious to see what the Marketing team has been working on recently, simply checking the knowledge base will provide speedy answers without having to reach out to the Marketing team and waiting for a reply.


For companies collecting data and using this data to inform their projects and approaches, it can also be a crucial way to keep data accessible across teams. Keeping an internal knowledge base helps make certain that the time and energy that team members invest in gathering information and organizing it appropriately greatly increases the return on investment for these efforts, an important consideration for many fast-growing teams.


Provide more consistent service

Teams with external-facing roles can also provide more consistent service. In referencing a standard database of information, each team member knows that they are giving out the correct, most current information around a specific topic. Instead of spending time answering questions, project leaders can add the relevant information into the knowledge base. and Team members who are answering support requests can then use this information as a base to provide consistent service to users. More standardization of responses enables more consistent answers and the ability for customer support to be split amongst several team members without sacrificing great service. This approach bolsters the overall brand and provides a more professional perception of the company.


Build standardized processes

Development teams benefit from such internal knowledge bases to document how they approach building each feature, the attempts that were successful, and, sometimes, more importantly, the attempts that were unsuccessful. A project status log within the knowledge base helps guarantee that a succinct, consistent development process is followed and that no crucial steps are skipped. In setting up a fixed cadence that will be reflected in the knowledge base, teams can ensure that their output has consistent standards.


#External Knowledge Bases

Empower customers

Knowledge bases give customers the opportunity to onboard, gain more understanding, and problem-solve independently. Customers know that there is one place to go when they have questions or are looking for relevant content for their use case. This helps encourage users to use best practices when working with your product, improving the onboarding experience and encouraging them to seek out answers instead of automatically contacting support. Providing high-quality information for customers in an accessible way builds customer trust and empowers them to think more creatively. Forums or discussion areas within knowledge bases help customers collaborate and use each other’s experiences to solve problems and create new solutions.

Build a consistent brand

Knowledge bases send a clear message to your users that the brand is invested in the success of all of its users. Creating a knowledge base that helps with troubleshooting, building new projects, and more also establishes a singular source where all users can go to get more information. Teams can work to curate the information in a way that is consistent with the values they wish to champion. Creating a single place where customers can go to look for resources, ensures that each customer receives a consistent message and helps standardize the approaches. In creating a consistent voice for external assistance, teams build a strong reputation for support and can easily tailor their voice for connecting with the community.

Reduce support requests while providing high-quality service

One of the most tangible benefits of investing time and energy into a knowledge base is reducing the number of support requests by providing more information upfront. If a knowledge base answers the most common questions of users and provides information on the best practices, users go into the early phases of their project well informed with all the tools they need. This helps prevent support requests down the line due to poorly constructed projects or just a lack of understanding on how to get the most return on investment from the get-go. By having a detailed repository of information, customers will have the feeling that the company cares about the broader community of users, not just the enterprise or high-paying ones, which can lead to more customer loyalty and brand adoption.

Frequently Asked Questions

Blog Author

Emily Nielsen

Emily Nielsen

Emily manages content and SEO at Hygraph. In her free time, she's a restaurant lover and oat milk skeptic.

Share with others

Sign up for our newsletter!

Be the first to know about releases and industry news and insights.