Troubleshoot Wiki Pages
Fix missing pages, stale content, edit issues, and confusing wiki structure.
Use this checklist when a wiki page is missing, hard to find, or not showing the content the team expects.
Page Is Missing
Search by title first. If the page still does not appear, check whether the wiki or docs module is enabled and whether the user has permission to view wiki content.
Also clear filters or search text before assuming the page was deleted.
Also confirm the user is in the correct workspace. A page created in one organization will not appear in another.
Page Is Hard to Find
Rename the page with clearer words. Use the terms your team naturally searches
for, such as Invoice Follow-Up instead of Finance Notes.
Also add related terms inside the page body. Search may find the page by words
in the content even when teammates do not remember the exact title. For example,
a page titled Payment Follow-Up can mention invoices, overdue balances, and
collections.
Improve Findability
When teammates cannot find a wiki page, update more than the title:
- add common search terms in the first section
- link it from related wiki pages
- move it into the right section
- remove outdated duplicates
- add the owner or review date when the process changes often
Search works best when the page uses the same words the team uses in daily work.
Content Looks Stale
Check the process owner and update the page before the team follows outdated steps. Add related links so users can verify current files, forms, or records.
If the page describes a workflow, integration, finance process, or HRM policy, test the process before rewriting the page so the instructions match current behavior.
Do not update a process page from memory when the related workflow, template, form, or setting can be checked directly.
If the current process is unclear, mark the page as needing review and link the source record, workflow, template, or setting that should be checked. Do not quietly rewrite a policy or billing process without the owner confirming the new instruction.
User Cannot Edit
Check the user's role permissions. Some users may be able to read wiki pages but not edit them.
If several users cannot edit, review module access and role configuration. If only one user is affected, check direct permissions and organization membership.
Page Opens But Instructions Are Wrong
When the page exists but the steps are wrong, verify the related app area before rewriting. Open the current form, workflow, finance template, setting, or integration and compare it with the wiki instructions. Then update the wiki with the current path and add a review note so users know the process was checked.
If the page describes a policy, ask the process owner to approve the change before publishing new instructions.
Duplicate or Conflicting Pages
When two pages disagree, keep the one with the current owner, latest review, and links to the active workflow. Merge useful content into the current page, then rename or archive the stale page so search results do not keep sending users to old instructions.
After resolving duplicates, update links from chat threads, tasks, onboarding docs, and related wiki pages where possible.
Prevent Repeat Confusion
After fixing a wiki issue, add a short owner or review note to the page. For critical finance, HRM, security, or customer processes, schedule a periodic review so the page does not become stale again.