OBLYTECH Logo
OBLYTECH Logo
ServiceNow HR Knowledge Management Testing and Acceptance Checklist
Home / Guides, Services and Solutions / HR Service Delivery: Guides and Services / HR Knowledge Management: Guides and Services / ServiceNow HR Knowledge Management Testing and Acceptance Checklist

ServiceNow HR Knowledge Management Testing and Acceptance Checklist

Test Layers and Scope

HR knowledge management testing spans multiple layers: content layer (are articles accurate and complete), platform layer (does search work, do articles display correctly), integration layer (does knowledge sync with source data), and user acceptance layer (do employees find value).

Content testing involves subject matter experts (HR staff) reviewing articles for accuracy, completeness, and alignment with current policies. Platform testing is performed by the platform team and covers search, filtering, display, and mobile access. Integration testing verifies that knowledge content stays synchronized with source systems (if articles are generated from policy documents stored elsewhere).

Entry and Exit Criteria

Entry criteria for testing: all planned articles are written, platform configuration is complete, integrations are wired up, and training materials exist. A common mistake is starting testing with incomplete content; you miss significant coverage gaps if you test only a subset of the planned articles. Test all articles before go-live to ensure comprehensiveness.

Exit criteria before go-live: all content has been reviewed and signed off by HR stakeholders, search functionality works and returns relevant results, mobile access is tested and acceptable, integrations pass validation, and end-user training is complete. A critical exit criteria: all identified defects must be resolved to at least severity 3 (cosmetic issues can wait, but functional defects must be fixed).

Content Accuracy and Completeness Checklist

Create an HTML table listing each article planned for launch. For each, verify: (1) content is accurate and reviewed by the subject matter expert (SME), (2) policy references are current, (3) contact information is accurate (avoid putting direct phone numbers or emails; use department names and links to contact forms instead), (4) legal disclaimers are included where needed (HR policies often carry compliance requirements), (5) cross-references to related articles are correct, (6) no outdated examples or scenarios.

Special attention to compliance-related articles (benefits, leave policy, discrimination/harassment). Have legal review these before publishing. Do not assume that current policy documentation is legally accurate; policies change and documents may not be updated at the same cadence.

Platform Functionality Checklist

Test in a production-like environment. Verify: (1) search returns relevant articles (search for common employee questions and confirm articles appear), (2) article metadata is accurate (titles, keywords, categories), (3) articles display correctly across devices (test on mobile, tablet, desktop), (4) navigation works (related articles links, breadcrumbs), (5) permissions are correct (only authorized employees can see sensitive articles), (6) article versioning is working if implemented, (7) ratings and feedback mechanisms work, (8) knowledge integrations update correctly (if articles are synced from source systems, confirm sync works).

Search and Discovery Testing

Create a test matrix of common employee questions. For each question, perform a search and verify that relevant articles appear in the top results. Examples: “How do I request time off?”, “What is my benefits enrollment deadline?”, “How do I update my direct deposit?”, “What is the parental leave policy?”

Test edge cases: searches with misspellings (users often misspell technical terms), searches using synonyms (employees might search “vacation” when articles use “paid time off”), searches in different languages if your employee base is multilingual.

Identify no-result searches and document them as gaps. If important questions return zero results, either create articles or update article metadata so keywords trigger the relevant articles.

Evidence to Keep

Maintain a test log documenting what was tested, when, by whom, and results. Include screenshots of search results and article display to prove functionality was verified. Keep SME sign-offs on article accuracy (email confirmations or sign-off forms). Store test results in a central location (a SharePoint folder or ServiceNow project) so you can refer to them if issues arise post-launch.

Document known limitations. If certain article types do not display well on mobile, or if search does not yet support synonyms, record these so the team knows they are accepted limitations, not bugs.

Regression Traps and Common Pitfalls

Scope creep: if new HR policies are announced during testing, do not try to create articles and test them before launch. Document them as post-launch content. Launching with incomplete or untested articles is riskier than launching with fewer articles and adding more later.

Metadata drift: article titles in the system may not match article titles in navigation, or keywords may be out of sync. Automate metadata review: query knowledge articles and confirm that every article has at least 3 keywords, categories are assigned, and titles are unique.

Stale reference data: if articles reference roles, departments, or contact information, that data must be kept current. Articles that direct employees to contact “the benefits office” become useless if that department reorganizes. Use department names and workflow-based contact methods instead of individual names or static contact info.

User training gaps: testing may pass but employees do not know the knowledge base exists. Incorporate promotion into your testing plan: confirm that knowledge articles are linked from the HR portal, email reminders direct employees to knowledge for common questions, and support staff are trained to suggest articles when answering similar questions.

Testing from the seat of each employee group

Much knowledge testing is run by people who know the content, which means it is run by people with more access and more context than the readers will have. An HR specialist can find every article without difficulty because they wrote the taxonomy. A new hire in their first week cannot. Acceptance testing should therefore be organized around the employee groups who will actually use the knowledge, each tested with an account that has only the access that group would have. The table below gives a starting set. Add rows for any group with a distinct entitlement or language need.

Employee group What they search for What must be true before sign-off
New joiner in the first week Start date logistics, equipment, first-day steps Onboarding articles appear without browsing beyond the first results page
People manager Approval routes, team leave rules, performance process Manager-only articles are visible to managers and invisible to a standard employee account
Employee on leave Benefit continuation, return procedures Articles are reachable from a mobile device on a weak connection
Contractor or temporary worker Only topics their role may read Restricted employee content is not returned in search, related lists or chat answers

Testing with an administrator account is useful for checking that content exists. It cannot confirm that restriction works, because an administrator is designed to see everything. A library signed off on an admin login can still expose a restricted article in public search results on the first day. Restriction behavior is the subject of the security and access design guide.

Triage categories for defects found during acceptance

Acceptance defects should be sorted by their effect on the reader, not by how much work the fix needs. A quick wording change can be a critical defect if it misstates an entitlement, and a long engineering task can be cosmetic if it only shifts a heading. Agree the categories before testing starts, so that disputes about priority do not delay the sign-off.

  • Critical: wrong entitlement, wrong eligibility rule, restricted content visible to the wrong audience, or a broken route to a case or form.
  • Major: a common question returns no useful article, a procedure step is missing, or a mobile view hides a required action.
  • Minor: a title that could be clearer, a link that opens the right page after one redirect, or inconsistent capitalization in a category name.
  • Deferred: a request for new content or a feature the platform does not currently offer, recorded for the post-launch backlog with an owner.

Rehearsing the cutover with a sample of real questions

A cutover rehearsal tests the whole route an employee takes, from the first search to the final action. Use a sample of questions drawn from the case queue, not invented ones, because invented questions tend to match the wording of the articles.

  1. Choose a set of recent case subjects covering the main categories, and write each one as an employee would type it into search.
  2. For each question, record the first article returned and whether it answers the question without a second click.
  3. Where the answer points to a form, submit the form through the employee account and confirm that the case or request is routed to the owner named in the article.
  4. Repeat the rehearsal with the restricted-content accounts, checking both what is visible and what is hidden.
  5. Log every failed step with its category, and hold the rehearsal again only after the critical and major items are closed.

The third step often reveals the most. An article that correctly describes a form can still route the submission to a group that was reorganized, and the employee sees a confirmation that the request was received by nobody in particular.

Testing rating and feedback features without distorting the data

Testers who press the helpful button on every article during acceptance will fill the feedback data with noise that looks like real employee opinion. Agree a separate test pass for feedback, run with clearly labeled test accounts, and confirm afterwards that the test ratings are excluded from the reporting. Otherwise the first month of live metrics will reflect the testers rather than employees, and the team may draw conclusions about content that no employee has read.

Questions raised at the acceptance meeting

Who should sign off acceptance?

Separate sign-offs for content, for access and for the cutover route work best. The content owner signs for accuracy, the security or platform owner signs for restriction, and the HR process owner signs for the routing. One sign-off for everything tends to be given by whoever is available, not whoever is accountable.

Can we accept the library with known search gaps?

Yes, if each gap is recorded with the questions it affects and a decision on whether it is covered by new content or by a case route. Accepting silently and discovering the gap in production is the outcome to avoid.

Do we need to test in languages we do not formally support?

Test the languages that appear in the workforce’s own searches. If employees search in a language that has no articles, that is a content gap to log, not a testing failure.

Should acceptance be repeated after a policy change?

Repeat the targeted rehearsal for the affected articles and their routes, not the whole library. A full retest after every small change makes the knowledge program too expensive to maintain. The governance model guide covers content ownership, including who reviews content after a policy change.

Related guides: ServiceNow HR Case Management Testing and Acceptance Checklist.

Frequently asked questions

How many articles should we test before launch?

Test all articles planned for launch, not just a sample. If you plan 50 articles, all 50 must pass content review and platform testing. Launching with untested articles leads to rework and staff frustration when articles contain errors.

Should we have employees test the knowledge base?

Yes, user acceptance testing with a sample of employees is valuable. Set up a pilot group (50-100 employees) and have them search the knowledge base and report issues. Pay special attention to whether employees can find answers to real questions they have. This is the truest test of effectiveness.

What should we do if critical articles fail review?

Delay launch of those articles, not the entire knowledge base. Launch with the articles that pass; add the failed articles in a follow-up wave after SMEs revise them. Missing articles on day one is acceptable; inaccurate articles are not.

Talk to Oblytech

Planning, running or fixing a ServiceNow programme? Tell us where you are and we will suggest a sensible next step.

Contact us