New: Create FAQs using the new WYSIWYG editor

You can now write FAQs natively in Brandkit using a new dedicated FAQ creation workflow —that offers a WYSIWYG/Markdown editor (no HTML skills needed), easy image insertion, and new ‘FAQ’ Asset Type.

Then use our FAQs Smart Section in the CMS page editor to organise those FAQs in a document like structure on the page.

This new way of producing FAQs essentially atomizes the traditional FAQs document or page into separate searchable frequenty asked questions and and answers. Then those individual FAQs are assembled into a single web page - akin to a document - but with several advantages.

Advantages over traditional approaches

• Single source of truth for your FAQs
• No more potentially out-of-date copies of PDF or printed documents out in the world.
• No more sending out new version updates
• No more printing costs
• Editable in real-time
• Always up to date
• FAQs are search-able - saving time.
• Brandkit FAQs form part of your brand knowledge base and are automatically exposed as knowledge resources to AI (LLMs, Chatbots and Agents)

How to create a FAQ

In Admin

1. Click the + Add button (top right)
2. Select the + Add FAQ option/workflow
3. Enter the title, body, and summary
4. Click Save and add metadata
5. Add metadata, such as Tags, change the vault if needed, etc. (FAQs have many of the same attributes as other Asset types).
6. Once you are happy - Approve the Asset to publish. Remembering that a Draft Asset won’t appear in the Portal.

How to assemble FAQs and publish a FAQs page in your Brandkit

Create a new page

First we need to create a FAQs page (or add an FAQs section to an existing page) in the CMS.

1. In Admin
2. Click CMS on main menu (left)
3. Click Portal
4. Click + New Page (or navigate to an existing page where you want to add an FAQs section - skip the next step in this case)
5. Name the page: faqs (or similar)
6. Add a section - select the Faqs section type.
7. Give the section an ID name - such as ‘faqs’
8. Optionally give the section a class name or names for CSS targeting
9. Select an Album if needed. Default is No Album - meaning all approved FAQs, but you can organise your FAQs into albums if you prefer (e.g. Search FAQs, Licencing FAQs, etc)
10. Select a Layout option - Collapse, Plain.
11. Choose a sort order for your FAQs
12. Choose visibility options
13. Save
14. Preview and edit as necessary.

All your approved (aka Published) individual FAQs are automatically included in the Smart Section (provided the default No Album option is selected).

Adding a Brand Guidelines menu item

You may also want to add an FAQs menu item in the main navbar or footer menu (if you created a new FAQs page) —to wire up th your new FAQs page. You can add this in the Portal Layout via the CMS using standard HTML

e.g. add a line to the navbar layout along the lines of:

<a href="/faqs" title="See our FAQs">FAQs</a>

Tip: You don’t necessarily need a custom page for your FAQs if you don’t want to. You can just link your menu item to a search for the Asset Type: FAQ

e.g.

subdomain.brandkit.com/?type=faq

or

subdomain.brandkit.com/assets?type=faq

Making changes

Want to Edit an individual FAQ - just navigate to the specific FAQ in Admin > Assets > and click Edit.

Want to edit the order of FAQs, or the FAQs page style, find the page in the CMS and edit page (or the FAQs section if part of another page).

Want to remove an individual guideline -just Archive or Unapprove the FAQ Asset.

The Asset will be automatically removed from any page it had been added to.

Like a normal Asset in other ways

FAQs have tags and and respect Vault visibility permissions like any other Asset. So if you have individual FAQs that should only be visible to your Staff for instance, just add the individual FAQ to a Vault that only your Staff can see.

Notify users about changes

Because individual FAQs are now Assets, you can now easily notify users about changes or updates to your guidelines.

No need to distribute a copy of your whole FAQS document again - just let users know there is an update and they’ll get a link to see the changes to the individual FAQ directly in your Brandkit.

Just select the individual FAQ (or multiple FAQs) and then the Share button.

Then click Share again and select the users you want to send it to.

Easy.

AI Knowledge Base

One of the main advantages of creating digital FAQs in Brandkit is that these FAQs are automatically prepared as plain text and HTML files (that act like a site-map to your data) suitable for AI (LLMs, Chatbots and Agents).

Lear more about the Knowledge Base feature in Brandkit here.