Skip to main content
← All apps

Content

Knowledge base

This manual is a draft and may change.

What it does

The Knowledge base is one place for your written know-how. Keep private staff procedures there, and publish a help center for customers or members from the same list. Every change to an article is saved as a version, so you can go back.

Who uses it

  • Knowledge editors: write, publish, archive, restore older versions and create share links.
  • Staff readers: read the private procedures and the help articles, without changing them.
  • Members and the public: read the published help articles meant for them.

Setup

  1. Ask your 1vsM contact to install Knowledge base on your site.
  2. Give each staff member a knowledge role: Knowledge editor for people who write, Staff reader (private SOPs) for people who only read.
  3. Open Knowledge base and click New article to create your first article.
  4. Create a few top-level sections first, then place articles inside them using the Section field.

Admin tasks

Knowledge base

  1. Open Knowledge base. You see a table of articles with Title, Address, Audience, Status and Version. Editors also see archived articles.
  2. Click New article. Enter a Title, an Address (lowercase words joined by "-", for example shop/opening), choose Audience (Public help, Members help or Internal SOP), Status (Draft or Published), a Section, an Order (lower numbers come first) and the Body.
  3. The Body uses simple formatting: # for headings, bold, *italic*, lists, quotes and links. Any HTML you type is shown as plain text.
  4. Click Create article, or Save article when editing.
  5. To share a public or members article by link, open it and under Share links optionally set Link expires (optional), then click Create share link. Copy the link right away; it is shown only once.
  6. To stop a link working, click Revoke next to it in the list.
  7. To go back to an earlier version, open the article, find it under Versions, and click Restore. This adds a new version with the old text.
  8. To remove an article, click Archive article. Click Restore from archive to bring it back. Articles are never permanently deleted.

Member view

Members and visitors use the help center, not the admin tab. They see only published articles for their audience, can search, and can open a share link you send them. Internal SOPs are never shown to them.

Styling it to your brand

The Knowledge base takes its colours, fonts and corners from the brand profile you enter once in 1vsm.com's Brand intake. That profile applies to every app automatically, so your help center matches the rest of your site.

Troubleshooting

  • I cannot see the Knowledge base tab. You need the Knowledge editor or Staff reader role.
  • "Your role can read the knowledge base only." Readers cannot change articles; ask an editor.
  • "Enter an article title." The title is required.
  • Address error. Use lowercase words joined by "-", like shop/opening.
  • "That address is already used by another article." Pick a different address.
  • Cannot create a share link. Internal SOPs cannot be shared; change the Audience first.
  • "Your session expired." Reload the page and try again.
  • The link I made does not open. It may have been revoked, expired, or the article is no longer published.

FAQ

Can customers see my private procedures? No. Internal SOP articles are for staff only.

Can I undo a change? Yes. Restore any earlier version from the Versions list.

Can I delete an article? No. You can archive it and restore it later.

Is a share link shown again later? No. Copy it when it is created; you can only revoke it afterwards.

Can I add pictures? Not at this time. Articles are text with simple formatting and links.

What to connect

Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.