Title: Doc Page Last modified: June 18, 2025 --- # Doc Page * Resolved [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 4 weeks ago](https://wordpress.org/support/topic/doc-page/) * Hi, * How can I edit the Doc Page? To standardize the layout, I need to insert an image as a background in the main menu area. I use the Astra theme. * Thanks Viewing 15 replies - 1 through 15 (of 15 total) * Plugin Support [Sadman Sakib Nadvi](https://wordpress.org/support/users/sadmansakibnadvi/) * (@sadmansakibnadvi) * [10 months, 4 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18519563) * Hello [@kklo](https://wordpress.org/support/users/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](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! * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 4 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18519702) * Hi, [@sadmansakibnadvi](https://wordpress.org/support/users/sadmansakibnadvi/) * The image is not in the background of the Shortcode, the image is in the main menu, see the example: [https://cctur.net.br/instrutor](https://cctur.net.br/instrutor) and what is going wrong, see the link [https://cctur.net.br/doc/criar-cursos/](https://cctur.net.br/doc/criar-cursos/) This link [https://cctur.net.br/duvidas/](https://cctur.net.br/duvidas/), shows[ betterdocs_search_form] and [betterdocs_category_grid] correctly * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 3 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18522890) * Hello [@kklo](https://wordpress.org/support/users/kklo/) * The reason the background image isn’t appearing in **[https://cctur.net.br/doc/criar-cursos/](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/](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/](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, * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 3 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18524451) * Hi, [@iapial](https://wordpress.org/support/users/iapial/) * Ok. * I only have 4 widgets. I believe I can create the doc page with the PRO version. * I’ve tried creating the pages with Elementor, but I don’t have it. As I said, I don’t have the widgets and without them it’s not possible to create the Doc page. * Can you help me, how to solve this problem? [https://www.awesomescreenshot.com/image/55110252?key=3b561bce49d0da7946caec6f02d1a4c4](https://www.awesomescreenshot.com/image/55110252?key=3b561bce49d0da7946caec6f02d1a4c4) * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 3 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18526161) * Hi [@kklo](https://wordpress.org/support/users/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/](https://betterdocs.co/docs/betterdocs-provides-full-site-editor-support/) * Best regards, Pial * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18532769) * Hi [@kklo](https://wordpress.org/support/users/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, Pial * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18534317) * Hi, [@iapial](https://wordpress.org/support/users/iapial/) and [@sadmansakibnadvi](https://wordpress.org/support/users/sadmansakibnadvi/) * Thanks for the explanation. I chose to use another plugin, since this plugin is linked to Elementor PRO. Here’s a tip: Try to use free Elementor to develop and customize the page of this plugin. * Thanks * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18535220) * Hi, [@iapial](https://wordpress.org/support/users/iapial/) end [@sadmansakibnadvi](https://wordpress.org/support/users/sadmansakibnadvi/) * I managed to create the main page within Elementor, and it worked, but the individual page with the docs still doesn’t work. Is there any way to develop the page with Elementor? * I used the plugins: Pro Elements and Essential Addons for Elementor. * What widgets are used in the Single Doc Page layout? * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18535608) * Hi [@kklo](https://wordpress.org/support/users/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 * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18536139) * Hi, [@iapial](https://wordpress.org/support/users/iapial/) * I also use the plugins: Templately and Ultimate Addons for Elementor Lite. I suggest that in the next versions you can create an Elementor option. * I chose to create the Single Doc Page without Elementor through the BetterDocs item in the Customization section of the website.. * My question is how to create this page? How to configure it with the plugin’s configuration panel? I only found the configuration for the main page. What is the name of the Single Doc Page to be given to this dynamic page? * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18536192) * Hi [@kklo](https://wordpress.org/support/users/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: [](https://d.pr/v/l5jAK9)[ Dynamic Widgets BetterDocs](https://d.pr/v/l5jAK9) * ✅ 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 * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18536491) * Hi, [@iapial](https://wordpress.org/support/users/iapial/) * Ok. Without working with Elements, WordPress’ native editor mode, how can I create or customize the Single Doc Page? How can I configure it? There is a BetterDocs widget with templates, but I try to use it on a page, but it seems that it only works as an option to change the template, color, etc. * I have an image at the top of the page that is standard on the site, which can be used as HTML. Even the Single Doc Page part covers the main menu. * Image: [https://www.awesomescreenshot.com/image/55247751?key=42dc2e09d56bdb215c17b21af4c0b5ac](https://www.awesomescreenshot.com/image/55247751?key=42dc2e09d56bdb215c17b21af4c0b5ac) * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18537184) * Hi [@kklo](https://wordpress.org/support/users/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](https://betterdocs.co/docs/how-to-configure-doc-single-page/) - 🔗 [BetterDocs Homepage and Single Page Configuration](https://betterdocs.co/docs/configure-homepage-and-single-page/#2-toc-title) * 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 * Thread Starter [kklo](https://wordpress.org/support/users/kklo/) * (@kklo) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18537912) * [@iapial](https://wordpress.org/support/users/iapial/) * Based on all the information above, I decided not to use Elementor. I chose the Single Doc Page template, but I still got the same error. * I created another main page, without using Elementor, without anything, without a block, and I chose the default BetterDocs template, nothing appeared. * I added only Gutemberg blocks, the main page works OK. I tried to simply choose the Single Doc Page template in the settings, without creating a page or anything like that, but the error still appears. * I can’t understand why the errors are happening. I tried to deactivate the plugins one by one to check for conflicts, but it didn’t work. * I use the Astra theme. * I really like your plugin, but I can’t get it to work. I appreciate your help, but I think I’m going to give up. * Plugin Support [Pial](https://wordpress.org/support/users/iapial/) * (@iapial) * [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18539983) * Hi [@kklo](https://wordpress.org/support/users/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](https://d.pr/v/xoHMv5) ✅ 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: 4. - Toggling layout styles (sidebar, spacing, full-width, etc.) - Saving after each change to force a refresh - Making sure the Single Doc option is enabled 5. **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. 6. **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](https://betterdocs.co/docs/how-to-configure-doc-single-page/) - [Configure Homepage and Single Page – BetterDocs Guide](https://betterdocs.co/docs/configure-homepage-and-single-page/#2-toc-title) * 💬 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 Viewing 15 replies - 1 through 15 (of 15 total) The topic ‘Doc Page’ is closed to new replies. * ![](https://ps.w.org/betterdocs/assets/icon-256x256.png?rev=2953105) * [BetterDocs – Knowledge Base Docs & FAQ Solution for Elementor & Block Editor](https://wordpress.org/plugins/betterdocs/) * [Frequently Asked Questions](https://wordpress.org/plugins/betterdocs/#faq) * [Support Threads](https://wordpress.org/support/plugin/betterdocs/) * [Active Topics](https://wordpress.org/support/plugin/betterdocs/active/) * [Unresolved Topics](https://wordpress.org/support/plugin/betterdocs/unresolved/) * [Reviews](https://wordpress.org/support/plugin/betterdocs/reviews/) * 15 replies * 3 participants * Last reply from: [Pial](https://wordpress.org/support/users/iapial/) * Last activity: [10 months, 2 weeks ago](https://wordpress.org/support/topic/doc-page/#post-18539983) * Status: resolved