BetterDocs
BetterDocs is a WordPress knowledge base and documentation plugin from WPDeveloper that runs first party inside the site own WordPress installation. Its optional Analytics, Instant Answer and live Search features record documentation searches, article views and helpfulness votes, setting cookies in the visitor browser and logging search queries that can be personal data. Because this analytics layer is non essential, the search and analytics tracking must load only after the visitor has given consent, while the plain documentation display can remain cookieless.
What does BetterDocs do?
What BetterDocs is
BetterDocs is a knowledge base and documentation plugin for WordPress developed by WPDeveloper. It lets site operators build a searchable help centre with categorised articles, an instant answer widget and a live search box, all served first party from the site own WordPress installation. The core documentation display renders as ordinary WordPress content, while optional features add search, analytics and reporting on how visitors use the help centre.
What data and cookies its analytics feature collects
The plain knowledge base display does not need to track visitors, but the optional Analytics, Instant Answer and live Search features do. When these are enabled, BetterDocs records the documentation searches a visitor types, the articles they view and the helpfulness votes they cast, and it stores these interactions in the site own WordPress database. To attribute searches and votes and to avoid counting the same interaction twice, BetterDocs writes cookies to the visitor browser. Logged search queries can reveal what a person was looking for and, combined with other data, can amount to personal data.
GDPR and ePrivacy implications
The search logs, view counters and helpfulness votes that BetterDocs Analytics collects relate to identifiable visitors and are therefore personal data under the GDPR. Writing and reading cookies on the visitor device to support these features falls within Article 5(3) of the ePrivacy Directive, which the CNIL in France under the TDDDG, the German authorities under the TDDDG and the AEPD in Spain under the LSSI CE all enforce as a strict prior consent obligation for non essential trackers. Because the plugin runs first party, the site operator is the controller for this processing.
When consent is required
Consent is required before the BetterDocs analytics and search tracking features set their cookies, because they are not strictly necessary for a visitor to read the documentation. That consent must be freely given, specific, informed and unambiguous, and refusing must be as easy as accepting. Until the visitor accepts, the analytics and search cookies should not be written and search queries should not be logged against an identifier. The plain documentation display, served without these cookies, does not require consent and can continue to work for every visitor.
Data transfers through the Google Analytics integration
By itself BetterDocs keeps its data inside the site own WordPress database, so no transfer to a third country occurs. A transfer arises only where the site operator enables the optional Google Analytics integration, which forwards documentation events to Google LLC, a United States based company. In that case European visitor data leaves the site own infrastructure and the transfer must be covered by the EU Standard Contractual Clauses within the Google data processing terms, together with a documented Transfer Impact Assessment in line with the Schrems II ruling. If the integration is left disabled, BetterDocs does not send data outside your own hosting.
Practical steps for compliant use
Keep the plain knowledge base display cookieless and gate the BetterDocs Analytics, Instant Answer and search tracking features behind your consent management platform so their cookies fire only after the analytics category is accepted. Describe BetterDocs in your cookie policy, including the cookies it sets and their lifetime, and explain that documentation searches are logged. Apply the shortest workable retention to the search logs and analytics counters in your WordPress database. If you enable the Google Analytics integration, disclose the transfer to the United States and complete a Transfer Impact Assessment, and leave the integration off where it is not needed.
BetterDocs and the GDPR
BetterDocs is classified as “Analytics”. On a site that targets European visitors, it must only load after the visitor consents, and it must be listed in your cookie policy.
- Legal basis
- When the BetterDocs Analytics or search tracking feature is enabled, prior, freely given, specific, informed and unambiguous consent under Article 6(1)(a) GDPR is required, because the plugin then writes cookies to the visitor terminal and logs search queries that can constitute personal data. Article 5(3) of the ePrivacy Directive 2002/58/EC, transposed as the French TDDDG applied by the CNIL, section 25 of the German TDDDG and Article 22.2 of the Spanish LSSI CE, makes prior consent mandatory before these non essential cookies are set. The plain knowledge base display, served without analytics cookies, can rely on the site legitimate interest, but the analytics and search tracking layer cannot.
- Risk level
- medium
- Applicable regulations
- GDPR, ePrivacy Directive 2002/58/EC, French TDDDG and CNIL guidelines on trackers, German TDDDG, Spanish LSSI CE and AEPD cookie guide, EDPB Schrems II Transfer Impact Assessment where the Google Analytics integration is enabled, EU Standard Contractual Clauses 2021/914
Impact assessment (DPIA)
A Data Protection Impact Assessment is usually not mandatory for a self hosted knowledge base, but it is advisable when BetterDocs Analytics is used at scale or combined with the optional Google Analytics integration. Document the cookies set by the analytics and search features, the search queries logged in the WordPress database, the article view and helpfulness vote counters, the retention applied to these logs and, where the Google Analytics integration is enabled, the transfer of documentation events to the United States. Configure BetterDocs so that analytics cookies load only after consent and keep the plain documentation display cookieless.
Sample text for your banner
We use BetterDocs, a knowledge base plugin, to help you search our documentation. When you accept, BetterDocs stores cookies on your device and logs your documentation searches, article views and helpfulness votes so we can improve our help content. If our Google Analytics integration is active, this data may also be sent to Google in the United States under the EU Standard Contractual Clauses. The plain documentation is shown without these cookies.
What BetterDocs sets and contacts
- Tracking method
- First party WordPress plugin developed by WPDeveloper that runs inside the site own WordPress installation. The knowledge base display itself needs no tracking, but the optional Analytics, Instant Answer and live Search features record documentation searches, article views and helpfulness votes and store these interactions and search queries in the site own WordPress database. When these features are active, BetterDocs sets cookies in the visitor browser to attribute searches and votes and to prevent duplicate counting. An optional Google Analytics integration can forward documentation events to Google, which introduces third party tags and a transfer outside the site own infrastructure.
- Server location
- The site own WordPress hosting. BetterDocs is a self hosted plugin, so documentation content, search logs, analytics counters and any cookies are processed within the WordPress database and server chosen by the site operator. There is no BetterDocs operated cloud, so the storage location is wherever the WordPress site is hosted. If the optional Google Analytics integration is enabled, documentation event data is additionally sent to Google infrastructure, which is based in the United States.
Cookies set (3)
| Name | Type | Duration | Purpose |
|---|---|---|---|
| betterdocs_analytics | HTTP cookie (first party) | Session | Set by the BetterDocs Analytics feature to attribute documentation searches and article views to a single visit and to avoid counting the same view more than once. |
| betterdocs_reactions | HTTP cookie (first party) | 12 months | Records which articles a visitor has already rated through the helpfulness vote so that BetterDocs does not count duplicate votes from the same browser. |
| betterdocs_search_history | localStorage | Persistent (until cleared) | Stores recent documentation search terms in the browser to power the instant answer and live search experience of the knowledge base. |
Frequently asked questions about BetterDocs
Can't find your question? Write to us, we answer fast.
What cookies and storage does BetterDocs set?
When its Analytics, Instant Answer or live Search features are enabled, BetterDocs writes first party cookies to attribute documentation searches and article views and to stop the same helpfulness vote being counted twice, and it can keep recent search terms in browser storage. The plain knowledge base display, without these features, does not set tracking cookies.
Do I need consent before BetterDocs tracking runs?
Yes, when the analytics or search tracking features are enabled. They write non essential cookies and log search queries, so under the ePrivacy rules you must obtain prior consent before those features run. The plain documentation display, served without these cookies, does not require consent.
What is the legal basis for BetterDocs analytics?
When the analytics or search tracking is active, the only valid basis is consent under Article 6(1)(a) GDPR, combined with the prior consent requirement of Article 5(3) of the ePrivacy Directive. Legitimate interest cannot cover these non essential cookies. The plain documentation display can rely on legitimate interest because it sets no tracking cookies.
Does BetterDocs transfer data to the United States?
Not by itself. As a self hosted plugin, BetterDocs keeps its data in your own WordPress database. A transfer to the United States arises only if you enable the optional Google Analytics integration, which sends documentation events to Google. In that case you need the EU Standard Contractual Clauses and a Transfer Impact Assessment.
Do I need a DPIA for BetterDocs?
A Data Protection Impact Assessment is usually not mandatory for a self hosted knowledge base, but it is advisable when BetterDocs Analytics is used at scale or combined with the Google Analytics integration. Assess the cookies, the logged search queries, the view and vote counters and, where relevant, the United States transfer.
How do I implement BetterDocs compliantly?
Keep the plain documentation cookieless and load the Analytics, Instant Answer and search tracking features only through your consent management platform after the analytics category is accepted. Describe BetterDocs in your cookie policy, apply a short retention to the search logs and, if you use the Google Analytics integration, document the United States transfer.
Are there alternatives to BetterDocs?
Alternatives include Heroic Knowledge Base, weDocs, Echo Knowledge Base, Documentor and hosted tools such as HelpScout Docs or Document360. Each raises its own cookie, consent and transfer questions, so check whether they are self hosted or cloud based and review their data processing terms before assuming any is lighter on privacy.
How do I update my cookie policy for BetterDocs?
Add an entry that names BetterDocs, lists the analytics and search cookies with their lifetimes, explains that documentation searches, article views and helpfulness votes are recorded, and states that no data leaves your hosting unless the Google Analytics integration is enabled. If it is, disclose the United States transfer and its safeguard.
LiveJournal
LiveJournal is a foundational web service that powers critical website functions and digital experiences. It provides reliable infrastructure, seamless integration capabilities, and consistent performance across all devices and browsers. LiveJournal supports modern development practices and scales with growing business needs. With a focus on stability and compatibility, LiveJournal ensures your website delivers a smooth, uninterrupted experience to every visitor and search engine crawler.
BookStack
BookStack is a web technology service that provides essential functionality for websites and digital platforms. It delivers core capabilities that support site operations, content delivery, and user experience optimization. BookStack integrates seamlessly with modern web architectures, ensuring reliable performance and compatibility across browsers and devices. Trusted by businesses worldwide, BookStack helps organizations maintain robust websites that meet user expectations and technical requirements.
MODX
MODX is a development framework and toolkit providing developers with a structured foundation for building modern web applications. It offers reusable components, standardized architecture patterns, and comprehensive documentation. MODX accelerates development through code generation, testing utilities, and build optimization. With an active community and extensive ecosystem, MODX enables teams to build scalable, maintainable applications following industry best practices.
GraphCMS
GraphCMS is a web technology service that provides essential functionality for websites and digital platforms. It delivers core capabilities that support site operations, content delivery, and user experience optimization. GraphCMS integrates seamlessly with modern web architectures, ensuring reliable performance and compatibility across browsers and devices. Trusted by businesses worldwide, GraphCMS helps organizations maintain robust websites that meet user expectations and technical requirements.
School Kiwi
School Kiwi is a customer support and helpdesk platform that helps businesses manage, track, and resolve customer inquiries efficiently. It provides a unified ticketing system, knowledge base, and multi-channel support across email, chat, phone, and social media. School Kiwi features automated ticket routing, SLA management, and self-service portals, enabling faster resolutions, higher satisfaction, and reduced operational costs for support teams.
phpBB
phpBB is a foundational web service that powers critical website functions and digital experiences. It provides reliable infrastructure, seamless integration capabilities, and consistent performance across all devices and browsers. phpBB supports modern development practices and scales with growing business needs. With a focus on stability and compatibility, phpBB ensures your website delivers a smooth, uninterrupted experience to every visitor and search engine crawler.
Make your site compliant today.
Free up to 25,000 sessions a month. No credit card, no commitment.