← Back to NocoBase Page Converter

NocoBase Page Converter — User Guide

Automatically migrate your NocoBase v1 pages to v2 FlowModel format. Product by Inducera

Table of Contents

  1. Getting Started
  2. Connecting Your NocoBase Instance
  3. Understanding the Dashboard
  4. Analyzing Pages
  5. Free Trial (Demo Conversion)
  6. Paying & Converting Pages
  7. After Conversion — Verification
  8. Reporting Issues
  9. FAQ
  10. Data Security & Privacy

Getting Started

1. Create an Account

  1. Go to nbtools.inducera.eu
  2. Click "Register Free & Try It"
  3. Enter your name, email, and a password (company is optional)
  4. Accept the Terms of Service
  5. Check your email and verify your account

2. Log In

After verifying your email, log in with your email and password. You can also use "Forgot Password" if you need to reset it.

Connecting Your NocoBase Instance

Before we can analyze or convert any pages, you need to connect the converter to your NocoBase instance.

What You Need

How to Create an API Token in NocoBase

  1. Open your NocoBase instance
  2. Go to Settings → API tokens (or API keys)
  3. Click Create token
  4. Give it a name (e.g. "Page Converter")
  5. Set the role to Admin (the converter needs read access to page schemas)
  6. Copy the token

Connecting

  1. Paste your NocoBase URL in the first field
  2. Paste your API token in the second field
  3. The converter will test the connection automatically
  4. If successful, you'll be taken to the Dashboard

🔒 Security note: Your API token is stored only in an encrypted server-side session (24h timeout). It is never sent to your browser or stored permanently. Read more about data security.

Understanding the Dashboard

Once connected, the Dashboard shows all pages from your NocoBase instance in a table with the following columns:

ColumnMeaning
PageThe page name as it appears in your NocoBase menu
TabsNumber of tabs on the page
BlocksNumber of content blocks (tables, forms, detail views, etc.)
FieldsTotal number of fields across all blocks
NodesEstimated number of v2 nodes that will be created
ComplexityA 5-level indicator: Minimal → Low → Medium → High → Max
PricePer-page price in SEK (based on node count)

Page Complexity

The complexity score gives you a rough idea of how large and involved a conversion will be:

Selecting Pages

Click the checkbox next to any page to select it for conversion. The total price updates automatically as you select pages. Volume discounts apply when converting multiple pages.

Analyzing Pages

Click on any page name to see a detailed analysis:

This helps you understand what the converter will do before you commit.

Free Trial (Demo Conversion)

Every new account gets one free demo conversion to try the tool risk-free.

How It Works

  1. Select one page on the Dashboard
  2. Click "Try Free"
  3. The converter runs a full conversion — but with demo limitations:
  1. You'll see the full conversion result: nodes created, time taken, and any conversion notes

This lets you verify that the converter works with your specific NocoBase setup before paying.

Paying & Converting Pages

Pricing

Conversion Steps

  1. Select pages — check the pages you want to convert on the Dashboard
  2. Review quote — click "Convert Selected" to see a price summary with any volume discounts
  3. Pay via Stripe — you'll be redirected to a secure Stripe checkout
  4. Automatic conversion — after payment, conversion starts immediately
  5. See results — the progress page shows real-time status for each page

The 5-Step Conversion Pipeline

Each page goes through 5 steps:

  1. Export — Read the v1 page schema from your NocoBase
  2. Prepare — Resolve templates, analyze structure
  3. Convert — Transform all blocks, fields, actions, and layouts to v2 format
  4. Build popups — Create popup views and nested association views (this is often the longest step)
  5. Verify — Automatic read-back to confirm the v2 page was saved correctly

You can follow progress in real-time with live counters showing models saved, popups processed, and estimated time remaining.

What Gets Converted

The converter handles 30+ verified block types and features:

After Conversion — Verification

Conversion Notes

After each conversion, you may see Conversion Notes — a collapsible card showing important information:

IconSeverityMeaning
🔧Action neededYou need to do something manually (e.g. re-configure a specific plugin block)
⚠️WarningSomething was partially converted — verify it looks correct
ℹ️InfoInformational — no action needed

Always review conversion notes and take action on any 🔧 items.

Verifying in NocoBase

  1. Open your NocoBase instance
  2. Navigate to the converted page (it appears in the same menu location as the original)
  3. Check that:

💡 Tip: The original v1 page is never modified or deleted. Both the v1 and v2 versions exist side by side so you can compare them.

Rollback (Undo)

If a conversion didn't go as expected, you can undo it:

  1. The results page shows a rollback option for each converted page
  2. Click "Undo" to remove the v2 page
  3. This deletes the v2 route and root page model from NocoBase
  4. Your original v1 page remains untouched

⚠️ Note: Rollback removes the top-level v2 page. In rare cases, deeply nested popup models may remain as orphans — these don't affect functionality but can be cleaned up manually if desired.

Reporting Issues

We want every conversion to be perfect, and your feedback helps us improve.

Quick Feedback

After each conversion, you'll see a 👍/👎 prompt. This takes one click and helps us track overall quality.

Issue Report

If something didn't convert correctly:

  1. Click "Report Issue" (available after conversion)
  2. Select a category:
  1. Describe what you expected vs. what happened
  2. (Optional) Enter your email for follow-up
  3. Submit — conversion context is automatically attached to help us diagnose

Feedback Form

Use the ⭐ feedback form to share general impressions, suggest features, or report UX issues.

FAQ

Is my data safe?

Yes. The converter uses a server-to-server architecture. Your NocoBase API token and page schemas are processed entirely on our server and are never sent to your browser. Data exists only during the active conversion session. Read our full data security page.

What happens to my original pages?

Nothing. Original v1 pages are never modified, moved, or deleted. The converter creates new v2 pages alongside the originals.

Can I convert the same page twice?

Yes. Each conversion creates a new v2 page. You can convert, verify, undo, and re-convert as needed.

What if a page doesn't convert perfectly?

The converter handles the vast majority of standard NocoBase blocks. If a page uses unusual plugins or very custom configurations, some elements may not convert perfectly. You'll see this in the Conversion Notes with specific guidance on what to check or fix manually.

How long does a conversion take?

Do I need to keep my NocoBase running during conversion?

Yes. The converter communicates with your NocoBase instance in real-time to export the v1 schema and save the v2 page. Your instance must be accessible throughout the conversion.

What NocoBase versions are supported?

The converter works with NocoBase instances that have v1 (UI Schema) pages. It converts them to v2 (FlowModel) format. Your NocoBase instance must support v2 pages (typically NocoBase 1.x or later).

Can I get an invoice?

Yes. Contact us via the email link on the pricing page and we'll arrange invoicing.

Data Security & Privacy

For full details, see:

Need Help?

Last updated: March 2026

© 2026 Inducera. All rights reserved.

Terms of Service · Privacy Policy · Data Security · User Guide · Contact · Back to App