Doc Page

Hello @kklo,

Greetings! I hope you’re doing well.

To customize the background image of the main menu area on your Doc Page, please follow the steps shown in this video: https://d.pr/v/m9MBLm

Simply navigate to Customize > BetterDocs > Live Search, where you’ll find the option to update the background.

Let us know if you need further assistance.

Thank you!

Hello @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,

Hi @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,
Pial

Hi @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,
Pial

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,
Pial

Hi @kklo,

Thanks again for the detailed explanation and the screenshot.
So just to clarify: if you’re not using Elementor and are working with the default WordPress Classic editor , then you don’t need to create a physical page for the Single Doc Page. BetterDocs handles this dynamically in the background.

The Single Doc Page is automatically generated whenever someone clicks on a documentation article. What you can control is the layout and appearance of that dynamic page — things like header spacing, sidebar position, color scheme, background, etc.

To configure this through WordPress Customizer, follow these steps:

Go to your WordPress Dashboard → Appearance → Customize → BetterDocs → Single Page

Here you can adjust:

• The layout (with or without sidebar)
• Colors and fonts
• Breadcrumb and meta visibility
• Control over how much space is shown before the doc content (important if your image is being overlapped)

This should help you fix the issue where your site’s standard top image or header is being covered or hidden by the doc content.

📘 For a full walkthrough, I recommend checking out these two guides:

• 🔗 How to Configure the Single Doc Page in BetterDocs
• 🔗 BetterDocs Homepage and Single Page Configuration

These guides walk you through both the Customizer options and what to expect from the dynamic rendering of doc content. ✅ Quick Notes:

• The BetterDocs Customizer settings don’t create pages — they apply styling and layout options to dynamically generated doc views.
• If your header image or top section is being overlapped, check the spacing/padding settings in your theme as well — or use a small HTML block in your theme’s header if needed.
• You don’t need Elementor or any page builder here — just use the Customizer and the built-in BetterDocs layout engine.

Best regards,
Pial

Hi @kklo,

Thank you so much for your patience — and I really do understand how frustrating this must feel after all the effort you’ve put in. You’ve been very thorough, and I truly appreciate how clearly you’ve explained each step you tried.

Let me clarify a few things and guide you through what’s likely causing the issue. 🧩 First, a key technical note about theme compatibility

Since you’re using the Astra theme, it’s important to know that Astra is not a full block-based theme — so it doesn’t support the Full Site Editor (FSE) natively.

That means you won’t be able to build or modify templates like the Single Doc Page using Gutenberg’s FSE interface. Instead, you’ll need to rely on the Customizer, which is the standard method for customizing layouts in classic and hybrid themes like Astra.

Here’s a quick demonstration to show what that looks like in action:
🎥 BetterDocs Customizer Walkthrough – Video ✅ Now, what’s likely going wrong and how to fix it

You mentioned that you selected the default Single Doc Page template, but nothing appeared — that usually means there’s either a theme conflict, a page slug issue, or a rendering error.

Please try these steps one by one:

1. Check for slug conflicts
   Make sure you don’t have a manually created page with the same slug as your documentation base (e.g., /docs). That would prevent the dynamic page from loading.
2. Flush permalinks
   Go to Settings → Permalinks and click Save Changes — this can often fix dynamic routing issues.
3. Revisit Customizer settings
   Navigate to:
   Appearance → Customize → BetterDocs → Single Page From here, try:
   • Toggling layout styles (sidebar, spacing, full-width, etc.)
   • Saving after each change to force a refresh
   • Making sure the Single Doc option is enabled
4. Temporarily switch to a default theme
   Just to test — try switching to a default theme like Twenty Twenty-One, then check if the doc pages display. If it works, Astra is most likely overriding something unexpectedly.
5. Disable caching temporarily
   If any caching plugins are active (like LiteSpeed, W3 Total Cache, etc.), clear the cache and disable them briefly to rule out cached output.

📘 Helpful Resources:

• How to Configure the Single Doc Page
• Configure Homepage and Single Page – BetterDocs Guide

💬 Final Thoughts

I completely understand you’re feeling close to giving up, and I want to sincerely thank you for giving it this much effort. I genuinely believe you’re just one step away from having this work — and I’m more than happy to stick with you to the finish line.

If you’re open to trying again, I’ll continue to assist step-by-step. Or if you’d rather switch direction, I totally respect that too.

Whatever you decide, I’m here to help.

Warm regards,
Pial