Automatic.Umbraco.DocumentGenerator 1.0.4

🚀 Automatic Umbraco Document Generator

Save 10+ hours on every Umbraco website setup.
Instantly transform design screenshots and wireframes into complete Umbraco Document Types, Element Types, Properties, and a fully-populated Multilingual Content Tree using AI.

Website & demo video: https://umbraco-document-generator.vercel.app
Feedback, questions or bug reports: support.waqaslabs@gmail.com

🆕 What's New

1.0.4

Packaging only — adds the metadata required to list on the Umbraco Marketplace. No functional change from 1.0.3; there is no need to upgrade if you are already on it.

1.0.3

A security release. Upgrading is recommended for everyone.

• Security: test-mode licence keys are no longer accepted. Lemon Squeezy reports keys created by a test order as valid and leaves the accept-or-refuse decision to the application. This package did not check, so a test key unlocked Pro exactly like a paid one. Keys flagged as test-mode are now refused, in every build configuration.

Does this affect you? Only if the key in your configuration came from a test checkout rather than a real purchase. A key from a genuine subscription is unaffected and needs no action. If your dashboard drops to Free after upgrading, your key was a test key — contact support.waqaslabs@gmail.com and we will sort it out.

Previously in 1.0.2

A substantial release. If you are on 1.0.1 or earlier, please upgrade — several issues that prevented the dashboard or generation from working at all are fixed here.

New features

• Choose where Document Types are created. Every generated type now has a folder picker listing your existing Document Type folders, so schema lands where you organise it instead of always at the tree root.
• Choose where content is seeded. Every content node has a parent picker listing your real Content tree, so generated pages can go under any existing node — not just the root.
• Vary by Culture, per Document Type. A toggle on each type, defaulting to on when more than one publish language is selected. Turning it on makes every property on that type culture-varying.
• Block List content seeding (Umbraco 17+). Generated pages now arrive with their Block List populated from your designs, not just an empty property.
• Automatic Element Type detection. Section types are identified from the AI's own output rather than relying on a flag the model may omit, so a page's Block List always has blocks to allow. The per-row checkbox still lets you override any of it.
• Diagnostics you can find later. Warnings and errors from a generation run are recorded in Umbraco's own log, tagged [DocumentGenerator] and visible under Settings → Log Viewer — so a run that didn't behave can be diagnosed after the fact, not just watched live. Your designs and content are never written there.

Fixes

• The dashboard did not appear at all. The client bundle was emitted in a format Umbraco could not read its extension manifests from.
• Every API call failed. The backoffice API authenticated with a cookie scheme and answered requests with a redirect to the login page instead of JSON.
• "Expected start object" when generating a content tree. Block List values are now built as proper block data rather than raw JSON.
• "Cannot save content with an empty name" when seeding a culture-varying tree. Culture-varying documents take their name per culture; only the invariant name was being set.
• "The configured property editor UI could not be found" on generated properties.
• Your own Data Types are never adopted. The generator previously picked an arbitrary existing Data Type matching an editor, so a generated page could inherit an unrelated Block List and its block types. Built-in Data Types are now addressed explicitly, and a Block List is created per page type allowing only the Element Types generated with it.
• Structured properties are no longer filled with plain text. Multi URL Picker, Media Picker and similar editors store JSON; sample text written into them saved but then failed on read. They are now populated only with valid data, or left empty and reported.
• Rich text properties became plain textboxes because of an editor alias renamed in Umbraco 14.
• Multilingual selection did nothing. Generated types were always invariant.
• Upgrades no longer require clearing your browser cache. The bundle URL now changes per release, so a new version is picked up on the next load.
• Licence activations are counted correctly. Installations now register against your licence, so the 5-installation allowance is applied as intended.

Changed

• Requires Umbraco 14 or later. Umbraco 13's AngularJS backoffice cannot load this dashboard.
• Anthropic provider defaults to a current Claude model.
• The separate Create Custom Page panel has been removed — its job is now done by the parent picker on each content node.

💡 The Problem vs. The AI Solution

✨ Features Highlight

• 📷 AI Design Analysis & Clipboard Paste: Drag & drop screenshots, browse files, or press Ctrl + V (or Cmd + V) to paste copied screenshots directly from your clipboard!
• 🤖 Multi-AI Model Support: Works seamlessly with Google Gemini, OpenAI, Anthropic Claude, or Ollama (Self-Hosted / Local AI).
• 🔄 Dynamic Umbraco Version Awareness: Auto-detects your server's Umbraco CMS version (v14, v15, v16, v17, v18+) and instructs AI to generate version-optimized Document Types.
• 🏗️ Document & Element Type Workbench: Review, edit names, customize property aliases, toggle Element Types, set Vary by Culture, or remove items before committing to Umbraco.
• 📁 Destination Pickers: Choose the Document Type folder for each generated type, and the Content tree parent for each generated node.
• 🧱 Block List Generation: A Block List is created per page type, wired to the Element Types generated alongside it — and populated with content on Umbraco 17+.
• 🌳 Automatic Content Tree Population: Seeds live content nodes with real copy extracted directly from your design images.
• 🌍 Multilingual Publishing: Detects installed Umbraco languages (en-US, es-ES, fr-FR, de-DE, etc.) and seeds multi-culture content trees with localized sample text.
• 🛡️ Non-destructive: Your existing Document Types and Data Types are never modified. If an alias already exists, a new uniquely-named type is created instead.
• ⚡ 5-Attempt Free Trial: Comes out-of-the-box with 5 free generation attempts per site (up to 3 screenshots per analysis).

💡 Image Upload Best Practices for Maximum AI Accuracy

For the highest precision Document Type & Content Tree generation:

1. Clean, Focused Screenshots: Upload crisp, high-resolution screenshots of individual pages or visual sections.
2. Clear Typography: Ensure text in images is legible so Vision AI can extract exact copy into your Umbraco properties.
3. Modular Page Sections: Shorter, clearer page/section screenshots allow AI to dissect layouts into precise Block Element Types and Page Templates.
4. Use a capable model. Smaller, cheaper models often ignore parts of the requested structure. A mid or high tier model produces noticeably better Element Type and Block List results.

📋 Supported Umbraco Versions

Why not Umbraco 13? The dashboard is a Lit web component built for the Bellissima backoffice introduced in Umbraco 14. Umbraco 13's backoffice is AngularJS and cannot load it. Supporting 13 would require a second, separate UI rather than a compatibility shim, so it is out of scope rather than partially working.

Block List content seeding requires Umbraco 17 or later. On Umbraco 14, 15 and 16 the Block List property is still created and wired to your Element Types, but is left empty for an editor to populate. Umbraco's block storage format differs on those versions and this package only writes the format it has been verified against.

📦 Installation

Install the package into your Umbraco CMS project via NuGet:

dotnet add package Automatic.Umbraco.DocumentGenerator

Or via Package Manager Console:

Install-Package Automatic.Umbraco.DocumentGenerator

⚙️ Quick Configuration

Add your Account Key and AI settings to your Umbraco site's appsettings.json under the AutomaticDocumentGenerator section:

Option 1: Google Gemini (Recommended)

{
  "AutomaticDocumentGenerator": {
    "AccountKey": "YOUR_LICENCE_KEY",
    "AiProvider": "Gemini",
    "AiModel": "gemini-2.0-flash",
    "AiApiKey": "YOUR_GEMINI_API_KEY"
  }
}

Option 2: OpenAI (GPT-4o)

{
  "AutomaticDocumentGenerator": {
    "AccountKey": "YOUR_LICENCE_KEY",
    "AiProvider": "OpenAI",
    "AiModel": "gpt-4o",
    "AiApiKey": "YOUR_OPENAI_API_KEY"
  }
}

Option 3: Anthropic Claude (Sonnet 5)

{
  "AutomaticDocumentGenerator": {
    "AccountKey": "YOUR_LICENCE_KEY",
    "AiProvider": "Claude",
    "AiModel": "claude-sonnet-5",
    "AiApiKey": "YOUR_CLAUDE_API_KEY"
  }
}

Option 4: Ollama (100% Free & Self-Hosted AI)

{
  "AutomaticDocumentGenerator": {
    "AccountKey": "YOUR_LICENCE_KEY",
    "AiProvider": "Ollama",
    "AiModel": "llama3.2-vision",
    "AiApiKey": "http://localhost:11434"
  }
}

Leave AccountKey empty to use the free tier. The AI API key is yours — you obtain it from and pay your chosen provider directly; no AI usage is routed through Waqas Labs.

Tip: keep keys out of source control by setting them as environment variables instead: AutomaticDocumentGenerator__AccountKey and AutomaticDocumentGenerator__AiApiKey.

🚀 How to Use (Step-by-Step Guide)

1. Open Umbraco Backoffice: Log into your Umbraco Backoffice and click the Automatic Document Generator dashboard tab in the Content section.
2. Upload Screenshots: Drag & drop your client's design screenshots or wireframes (Homepage, About Us, Blog Detail, Contact, etc.).
3. Analyze Layout with AI: Click Analyze Layouts with AI. Watch real-time process logs as the AI interprets the layout architecture.
4. Customize the Workbench:
   • Edit Document Type names and property aliases.
   • Toggle reusable sections as Element Types for Block Lists.
   • Toggle Vary by Culture per type for multilingual sites.
   • Pick the Document Type folder each type should be created in.
   • Delete anything you don't want.
5. Generate Document Types: Click Generate Document Types to commit the schema into Umbraco.
6. Review the Content Tree: Switch to Content Tree Preview, choose your publish languages, and pick the parent node for each content node.
7. Generate Content Tree: Click Generate Content Tree.
8. Done! Refresh your Content section to see your pre-populated content tree.

Choose your publish languages before generating Document Types — culture variance is applied when the types are created.

🩺 Troubleshooting

• Dashboard doesn't appear after upgrading from 1.0.1 or earlier. Once only, clear the cached bundle: open DevTools (F12), right-click the reload button and choose Empty Cache and Hard Reload. Ctrl + Shift + R alone is not enough. From 1.0.2 onward this is handled automatically.
• A generation run didn't do what you expected. Go to Settings → Log Viewer in the backoffice and search for [DocumentGenerator]. Every skip and warning is recorded there with the reason.
• Block List left empty. Expected on Umbraco 14–16 (see the compatibility note above). On 17+, the log will state why.
• Types created with a _1 suffix. An alias of that name already existed, so a new type was created rather than modifying yours. Delete the earlier one if it was from a previous run.

Still stuck? Email support.waqaslabs@gmail.com with the [DocumentGenerator] log lines and we'll take a look.

Your designs and content are not written to your log files — only what the plugin did, and why anything was skipped.

💳 Pro Licensing & Support

• Free Trial: 5 free generation attempts per site out-of-the-box (3 screenshots max per analysis). No account or payment required.
• Waqas Labs Pro — $10/month: Unlocks unlimited generations, unlimited screenshot uploads, and use on up to 5 installations per licence key (typically a live site, a staging environment, and the developer machines working on it).
• Buy a licence: Subscribe on Lemon Squeezy — your key is emailed the moment checkout completes
• Website & demo video: https://umbraco-document-generator.vercel.app
• Support, feedback & bug reports: support.waqaslabs@gmail.com

Feedback genuinely shapes this roadmap — if something is missing or awkward for your workflow, please say so.

Commercial License © 2026 Waqas Labs. All Rights Reserved.