Internal KB
9 min
document your team's processes inside custify so the right guidance is one click away from the work itself overview the internal kb is your team's private documentation library, built directly into custify you write articles about your own customer success processes — onboarding playbooks, escalation paths, renewal motions, billing exceptions — and they live alongside the playbooks https //kb custify com/playbooks , lifecycles https //kb custify com/lifecycles , and segments https //kb custify com/segments those processes drive most cs teams keep their internal documentation in a separate wiki — confluence, notion, google docs — and lose context every time someone has to open a second tab to look up "how do we handle a downgrade request" or "what does our health score really measure " the custify internal kb closes that gap by putting the article and the operational tool that uses it on the same page the internal kb is different from custify knowledge docid\ vsptv6ih nazcx9qdyhk , the new ai grounding layer that ships in the same release custify knowledge ingests your data sources so custifyai can reason about your account; the internal kb is the human readable article module that you and your team read and write in the two pair well — custify knowledge can suggest draft articles for the internal kb based on patterns it sees in your data — but they are separate features with separate purposes the module covers four things a library of articles you author in a rich text editor, organised into folders, subfolders, and tags bidirectional links between articles and the custify entities they document — playbooks, lifecycles, segments — so process documentation surfaces in the workflow that uses it permission aware drafts and publishing so you can collaborate on a process before it goes live to the wider team a dedicated module in the main sidebar with a categories pane on the left and an article reader on the right the first release focuses on the article authoring experience and the cross linking layer ai assisted drafting, conversational querying outside the app (slack, email), and training mode for onboarding new hires are on the roadmap but are not part of this release creating an article you create articles from the dedicated internal kb module in the main sidebar the button to start a new article sits in the top right corner of the categories sidebar to create your first article open internal kb from the main sidebar pick the folder you want the article to live in, or click new category first if you need somewhere to put it click add content give the article a title and start writing in the editor when the draft is ready for review, switch the status from draft to published using the status selector in the top right the editor is a froala based rich text editor you get headings, bold and italic formatting, ordered and unordered lists, tables, links, code blocks, and inline images pasted content from other tools keeps its formatting where possible each article carries the following fields title the display name of the article shown in the categories sidebar and in any place the article is linked from body the full article content, written in the rich text editor status either draft or published drafts are visible only to users with edit permission on the internal kb; published articles are visible to everyone in the account category where the article lives in the categories tree can be moved later linked entities the playbooks, lifecycles, and segments this article documents set when you link from inside one of those features (see below) custify tip start with the article rough and switch to draft drafts are private to editors, so you can iterate with a co author without anyone in the wider team seeing half finished guidance observation image upload in the editor is supported, but very large images can slow down the article preview if a screenshot is heavier than a few hundred kilobytes, resize it before uploading linking articles to playbooks, lifecycles, and segments the point of the internal kb is that articles do not live in isolation — they sit next to the operational features they describe linking is bidirectional a playbook can list its related articles, and an article can list every playbook, lifecycle, and segment it relates to the links are created from inside an internal kb article open the linked entities panel on the right side of the editor and add the entity you want this article to document once linked, the relationship shows up everywhere the entity appears a csm viewing a playbook on a customer's customer 360 profile https //kb custify com/customer 360 profile sees the related articles in the same panel as the playbook itself, and can easily navigate to learn more about the process behind the flow custify tip when you build or edit a playbook, write the article first, then link it the article gives you a place to document the strategic reasoning ("we send this email at day 14 because that's when our trial to paid drop off happens") that does not fit inside the playbook ui itself querying the internal kb the internal kb has its own search bar at the top of the module search runs against article titles and body text results show the matching article, the category it lives in, and a short snippet of the matched text in a future release, the same article corpus will be queryable from custifyai's conversational interface — typing a question like "what is our refund process for annual customers" and getting the relevant article surfaced inline, grounded by custify knowledge https //kb custify com/custify knowledge for now, search and the categories tree are the primary ways to find articles custify tip cross link articles to each other freely the internal kb works best as a web of small, focused articles — one per process — rather than a few large all encompassing pages smaller articles are easier to update and easier to link from a playbook step managing the library the internal kb respects your account's role and permission setup three things are guarded viewing draft articles is limited to users with edit access on the internal kb published articles are visible to everyone creating, editing, and deleting articles is limited to users with the corresponding permission on the internal kb view only users can read but not change anything reorganising folders (creating, renaming, moving, deleting) is also gated by the edit permission you configure who has edit access from settings roles and permissions internal kb the default for new accounts is that admins and cs leaders have full edit rights, and regular users have view only access; adjust this to match how your team divides authoring and reading archived articles remain visible in the categories tree but are visually marked as archived and are excluded from the related articles pickers in playbooks, lifecycles, and segments this keeps superseded guidance available for reference without offering it up to a csm looking for a current process to archive or delete an article, open it and use the action menu in the top right corner archiving is reversible; deletion is not observation deleting an article also removes every link to it from any playbook, lifecycle, or segment it was attached to the entity itself is unaffected, but the related articles entry disappears if you only want to retire the article temporarily, archive it instead
