Pial
Forum Replies Created
-
Hi @kklo,
Thanks again for the follow-up — and I really appreciate your suggestion about future compatibility with the free version of Elementor.
Right now, the way Elementor integrates with dynamic content like the Single Doc Page relies heavily on a feature called Theme Builder, which is available only in Elementor Pro. That’s why even if you’re using helpful addons like Templately, Ultimate Addons Lite, or even Pro Elements, you still won’t see the dynamic doc widgets or be able to assign a custom template to single docs — because the core dynamic content support is missing without Elementor Pro. 🔍 Why it doesn’t work without Elementor Pro:
The Single Doc Page is a dynamic template — its content changes based on which doc the user is viewing. To design these types of templates in Elementor, the builder must support:
- Dynamic post content (like titles, body, author, etc.)
- Template assignment (so the layout applies automatically to all docs)
Unfortunately, free Elementor doesn’t include any of that. The BetterDocs – Single Doc Content widget (the one that renders your doc content inside Elementor) also won’t appear unless Elementor Pro is active.
These aren’t limitations from BetterDocs — we’ve already added full support for Elementor, but the actual rendering of dynamic content is something only Elementor Pro enables.
🎥 If you’re curious how it works when Elementor Pro is active, here’s a video:
Dynamic Widgets BetterDocs✅ Summary:
- The Single Doc Page can’t be built with Elementor Free because it lacks Theme Builder + dynamic content support
- BetterDocs Free works just fine — no Pro needed on our end
- The widget you’re looking for (Single Doc Content) is only available when Elementor Pro is active
- Addons like Templately, Pro Elements, or Ultimate Addons can’t unlock this functionality, because they don’t provide full Theme Builder capabilities
We completely understand the frustration — and we genuinely appreciate your input about making this more flexible for free Elementor users in the future. Hopefully Elementor expands access to their Theme Builder in time, which would open up a lot more possibilities.
In the meantime, if you ever switch to Elementor Pro or decide to use a Gutenberg-based theme or the Customizer route, feel free to check the previously given documents
Best regards,
PialHi @kklo,
Thanks so much for your feedback
Just to clarify a few things for future reference (and in case it helps anyone else who might run into the same situation) — glad to hear you were able to create the main page using Elementor — that’s a great start!
Now, regarding the Single Doc Page (the individual doc view):
To build or customize that with Elementor, it requires using Elementor’s Theme Builder, which is unfortunately a feature exclusive to Elementor Pro. Even if you’re using tools like Pro Elements or Essential Addons, those don’t actually unlock Theme Builder functionality — only the official Elementor Pro plugin does.
This isn’t a limitation on the BetterDocs side — it’s how Elementor itself is built, and we don’t have control over how their builder works or which features are locked behind their Pro version.
We’ve worked to make BetterDocs compatible with the most popular page builders (Elementor, Gutenberg, Customizer, etc.), but ultimately how far you can go with customization depends on what the builder itself allows in the free version.
🔧 What widgets are used in the Single Doc Page template (via Elementor)?
If you do happen to use Elementor Pro, here’s what you’d work with:
- BetterDocs – Single Doc Content
→ This is the core widget that dynamically loads the content of individual docs. And it will appear only if the Elementor Pro is active.
📌 Quick summary:
- ✅ You can customize the Single Doc Page layout with Elementor, but it requires Elementor Pro to access the Theme Builder.
- ✅ BetterDocs Free is fully sufficient — no need for BetterDocs Pro to create the layout.
- ❌ Plugins like Pro Elements or Essential Addons don’t give access to Elementor’s Theme Builder — so they can’t replace Elementor Pro for this specific task.
We totally understand the desire to keep everything working with the free version of Elementor — and we genuinely appreciate the suggestion. That said, because the layout is tied to dynamic content (i.e., the structure for each doc), Theme Builder is the only available method for that kind of templating within Elementor’s ecosystem.
If you ever decide to revisit this or need guidance on alternative layout methods using Gutenberg or the WordPress Customizer, feel free to reach out — happy to help however I can.
Wishing you all the best with your project!
Best regards,
PialHi @kklo,
Just checking in — did that explanation help clarify things for you?
Let me know if it answered your questions, or if there’s anything that’s still unclear.
And of course, if you run into anything else or need help setting things up, feel free to ask anytime. I’m here to help!Best,
PialHi @kklo,
Thank you for the clarification.
Let me explain a bit more clearly how this works so you can decide the best way forward.
To design or customize the Single Doc Page layout, there are generally two approaches:
1️⃣ Using the WordPress Customizer (Classic or Gutenberg-supported theme):
If you’re using a classic theme or a Gutenberg-supported theme, you can create and customize the single doc layout directly through the Customizer settings available in BetterDocs. No need for Elementor or Elementor Pro in that case.2️⃣ Using Elementor:
If you prefer using Elementor for building the Single Doc Page — like the example you showed with your main menu design — Elementor’s Theme Builder feature is required, and that is only available in the Pro version of Elementor.
This part is entirely related to Elementor itself; we don’t have any control over their free vs. pro feature limitations. Without Elementor Pro, you won’t have access to their Theme Builder to fully design single templates, including your doc layout.🟢 Good news: To create the single doc layout itself, you don’t need BetterDocs Pro — the free version of BetterDocs is already enough to handle the documentation structure and content display.
So in summary:
- ✅ BetterDocs Free = enough to create documentation & single doc pages
- ✅ Classic/Gutenberg-supported theme = can customize via Customizer
- 🔔 If you want full control with Elementor (like adding background images, custom headers, etc.) → that requires Elementor Pro for Theme Builder
If you’re open to using a Gutenberg-supported theme or customizing with the Customizer, you can achieve your goal without needing any paid tools. Here’s how : https://betterdocs.co/docs/betterdocs-provides-full-site-editor-support/
Best regards,
PialHello @kklo
The reason the background image isn’t appearing in https://cctur.net.br/doc/criar-cursos/ is because that page wasn’t built using Elementor.
For example, the page https://cctur.net.br/instrutor/ was built with Elementor, and that’s why the design, including the background image, is showing properly there.
To get the background image and full layout working as expected for your documentation pages, you’ll need to create a Single Doc Template using Elementor.
Here’s the guide for that:
🔗 https://betterdocs.co/docs/single-doc-in-elementor/Once you follow that, you should be able to set the background image and customize the layout just like you want.
Hope it helps
Best regards,
You’re very welcome @flatword ! Really glad that helped clarify things for you.
And seriously, appreciate your kind words. Always happy to help whenever you need it. Just drop a message anytime.
Have a great rest of your day!
Hi there @flatword ,
Great question!
In BetterLinks, a “unique click” means that a specific person (or device) clicked a particular link once within a 24-hour period. Even if they click the same link again during that time, it still only counts as 1 unique click.
How is it tracked?
It uses a combination of the IP address and browser information (user agent) to help determine if it’s the same visitor or not.
Some examples:
✅ Counted as unique:
You click the link from your phone — that’s 1 unique click.You then click it from your laptop within the same day — that’s another unique click (because it’s a different device/IP).
❌ Not counted again as unique:
You click the link from an open tab today, and then again a few hours later from the same device & same IP — still just 1 unique click for that 24-hour window.
After 24 hours pass, if you click again, it would then be counted as a new unique.
How accurate is it?
It’s a good estimate of how many different visitors are clicking your links, but it’s not 100% perfect. VPNs, dynamic IPs, or private/incognito browsing can sometimes make the numbers a little higher or lower than expected. Still, for most use cases, it gives a reliable view of engagement.
Hope that clears it up!
Let me know if you need more details or have any other questions.
Thanks for using BetterLinks!
Hi @phoenix36
Thank you for your feedback, and we’re sorry to hear about your concerns.
We want to reassure you that our plugin does not collect or send any personal data without the user’s clear and explicit consent. Nothing is gathered or transmitted unless the user has actively agreed to it.
During the onboarding process, we present a consent screen where users are invited to help improve the plugin by sharing anonymous usage data. This step is entirely optional, and there’s a clearly visible “Skip” button, users can decline and continue using the plugin with full functionality.
If a user chooses to provide consent at that stage, we may follow up with onboarding-related emails or helpful guidance, but again, only after receiving that explicit opt-in.
We take privacy and data security very seriously and make every effort to ensure users are informed and in control of their choices.
That said, we truly value honest feedback and want to make sure there’s no misunderstanding. If you’re open to it, we’d appreciate any additional details you can share about your experience. It would really help us better understand what happened and ensure nothing is being misinterpreted — especially since some of the points raised might unintentionally give the wrong impression to others.
Thanks again for taking the time to share your thoughts.
Looking forward to hearing from youHey @vishali009,
You’re very welcome — happy to help!
Regarding your new question, let’s break it down into two parts:
1. Using the Same Slug (e.g., “installation”) Under Different CategoriesThis one can definitely be a bit confusing, and you’re not alone in running into it.
Even though BetterDocs has the “Enable Category Hierarchy Slug” option — which helps generate more organized permalinks by including the category path in the URL — WordPress still applies its own rules behind the scenes.
The key thing to know is:
➡️ Every post (including Docs, since each Doc is technically a custom post type) must have a unique slug across the entire site.This is a core behavior in WordPress, and unfortunately, plugins — including BetterDocs — don’t have direct control over overriding that. So if you create two Docs both with the slug “installation” (even under different categories), WordPress will automatically rename the second one to something like installation-1 to avoid conflicts. 👉 Possible Workaround:
While it’s not perfect, one way to handle this is to include the category name as part of the doc title or slug.
For example:timeline-widget-installationcooltimeline-installation
This way, the URLs stay unique and users can still understand the context from the slug.
I totally get that this might not be exactly what you were hoping for, but it’s the most reliable method given how WordPress handles post slugs.
2. Making Subcategories Clickable / Linked on the FrontendAt the moment, BetterDocs doesn’t generate individual archive pages for subcategories (or nested categories). That means those subcategory names you see in the sidebar — they’re just used for grouping Docs visually, but they’re not linked or clickable by default.
So unfortunately:
➡️ Subcategories don’t have their own accessible pages or URLs on the frontend.If you’re looking for a way to list all docs under a subcategory when clicking its name, that’s something BetterDocs doesn’t support right now.
Thanks again for your thoughtful questions!
Best,
PialHey @vishali009
Thanks for reaching out!
So, the behavior you’re referring to, where selecting a main category (like WordPress) only shows its relevant docs in the sidebar, is actually part of the Multiple Knowledge Base feature in BetterDocs Pro.
You can read more about it here:
🔗 https://betterdocs.co/docs/multiple-knowledge-base/
🔗 And if you’re using Elementor: https://betterdocs.co/docs/multiple-knowledge-bases-elementor/Since it’s a Pro feature, we’re limited in what we can explain here, as per WordPress.org guidelines — all commercial product support needs to go through the appropriate channels outside the .org forums.
If you need more help with this, please feel free to reach us by following this:
👉 https://d.pr/i/Xq3AOOHope that clears things up a bit! Let us know if there’s anything else we can help with.
Best,
PialHi @flatword
Great questions—and you’re right, more flexibility around clearing analytics would definitely be helpful.
At the moment, the Reset Click Data option only supports two fixed timeframes: 30 days and 90 days. There’s currently no way to define a custom date range, and unfortunately, it’s also not possible to selectively clear data for specific URLs through the UI.
That said, if you want to remove analytics for a particular BetterLink, the current workaround is to:
- Delete that specific Shortlink—this will also remove its associated analytics data.
- Recreate the link—this gives you a clean slate and new data going forward.
We know it’s not ideal, and we’ve shared similar feedback internally—so hopefully more granular control over analytics data will be something we can offer in future updates.
Hope this helps clarify things! Let me know if you’d like assistance with anything else.
Hi @flatword
Thanks for confirming all that—and I really appreciate the detailed info.
You’re right, this is unusual. From what you’ve described, it sounds like the analytics data might not have been recorded correctly during that period. One possible cause could be caching interfering with the way header requests are passed to the database. If those requests don’t reach the server as expected, our system may miss or miscalculate clicks—especially when it comes to distinguishing between total and unique ones.
Unfortunately, if the data wasn’t captured properly at the time, there’s no way to retroactively fix it since it simply wasn’t logged.
That said, here’s what we recommend moving forward:
- Clear all layers of cache weekly—this includes server cache, site cache, object cache, and the BetterLinks cache. It’s a good standard practice to avoid tracking inconsistencies.
- In BetterLinks settings:
- Make sure “Disable Bot Clicks” is enabled
- And “Disable IP Addresses for Analytics” is not enabled
- Optionally, you can clear the last 30 days of analytics data to start fresh.
Here’s a quick guide on how to do all that: https://d.pr/v/froBiv
Once that’s in place, please observe the stats going forward. It should help avoid issues like this from happening again.
Let me know how it goes
Hi @flatword
Thanks for the detailed explanation—and yes, you’re absolutely right that unique clicks should never exceed total clicks. That kind of mismatch usually points to a data inconsistency, and we’d like to help get to the bottom of it.
To help us troubleshoot:
- Have you recently used any database cleaner or optimization tools?
- Are you using any new caching plugins or services (or made changes to existing ones)?
- Do you recall when this issue first started showing up—was it after a specific update or configuration change?
Also, just to be sure, please try clearing all levels of cache (server, site, object cache, and BetterLinks cache: how-to guide here) and then check if the stats realign.
Once we have that context, we’ll be better able to narrow down the cause—or step in from our side to investigate further.
Thanks
Hi there @flatword
Thanks for reaching out!
Normally, that shouldn’t have happened—clicks should register pretty quickly, even after a manual refresh. Since you’re not seeing anything show up, it’s possible the data is being held up by some kind of caching.
Could you please try clearing the following, just to rule it out?
- Your server cache
- Site-level cache
- Any object caches you might be using
- And finally, the BetterLinks cache (you can follow this guide to clear it: https://betterlinks.io/docs/how-to-clear-betterlinks-cache
Once you’ve done that, check the stats again and let us know if the clicks start appearing.
Thanks again!
Hi @jimdoneit
I’m so glad to hear that switching to BetterLinks resolved the issue and you like the migration process . That’s exactly what we hoped to deliver with this upgrade! And thanks for the info about the PHP upgrades we will test it again internally.
If you ever need any further help, please don’t hesitate to reach out. We’re always here for you.
Also—sorry to bother you—but if you don’t mind me asking, could you do me a small favor? It would mean a lot if you could take just 30 seconds to leave a 5-star review about your experience with the plugin and the support you received from me. It really helps us improve and continue providing great service.
Thanks so much in advance.
Wishing you an amazing day ahead. 😊
Warm regards,
Pial