MANIFEST-NAMESPACE-001

<extension> without namespace

Missing <namespace> in the manifest

Joomla 3 extensions lived as class FooController in a flat folder. Joomla 4+ components need a namespace and usually a service provider so MVC Factory can find classes.

<extension> without namespace<namespace path="src">Vendor\Component\Name</namespace>

Dies at Joomla 3 → 4J3: Works nativelyJ4: Changed behaviourJ6: Changed behaviourBC plugin: not applicableYou rewrite thisManifest / installer

What you will see

  • Class ... not found
  • Failed to create MVC factory

Symptoms people search

extension installs but every view 500s · no namespace in XML

Replace this code

Swap <extension> without namespace for <namespace path="src">Vendor\Component\Name</namespace>.

Joomla 3

Remove or stop calling this

<extension type="component" version="3.9" method="upgrade">

Joomla 4 / 6

Use this instead

<extension type="component" method="upgrade">
  <namespace path="src">Acme\Component\Lms</namespace>
  <!-- plus services/provider.php -->

How to fix it

  1. 1Add <namespace path="src">Your\Vendor\Component</namespace>.
  2. 2Move PHP into src/ matching PSR-4.
  3. 3Add services/provider.php for components, modules, and plugins.

Also known as

namespace · services/provider.php · PSR-4

Related issues

Get in touch

Have a project in mind? Let's talk about it.

Tell us what you're building. Whether it's a new site, an online store, a mobile app, or something that needs AI under the hood, we'll get back to you within a business day.

Free consultation
No commitment, no pressure
Reply within 24 hours
Usually much faster

Prefer a direct conversation?

Request a project quote

Tell us about your project

Fill out the quick form and we'll reach out.