Print Friendly and PDF

Problem creating an Eleventy Layout

Posted: April 10, 2026 | Categories: Eleventy

I was working on a new 11ty site this morning and while building the site, I encountered the following error:

[11ty] Problem writing Eleventy templates:
[11ty] 1. Problem creating an Eleventy Layout for the "./11ty-cat-pages.liquid" template file. (via EleventyBaseError)
[11ty] 2. You’re trying to use a layout that does not exist: _includes/base (via `layout: base`)
[11ty] 
[11ty] Original error stack trace: Error: You’re trying to use a layout that does not exist: _includes/base (via `layout: base`)
[11ty]     at TemplateLayoutPathResolver.getFullPath (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayoutPathResolver.js:115:10)
[11ty]     at new TemplateLayout (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayout.js:19:31)
[11ty]     at TemplateLayout.getTemplate (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayout.js:58:17)
[11ty]     at Template.getLayout (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/Template.js:187:26)
[11ty]     at #getData (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/Template.js:388:23)
[11ty]     at async TemplateMap.add (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateMap.js:70:14)
[11ty]     at async Promise.all (index 0)
[11ty]     at async TemplateWriter._addToTemplateMap (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:340:13)
[11ty]     at async TemplateWriter._createTemplateMap (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:351:3)
[11ty]     at async TemplateWriter.generateTemplates (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:382:3)
[11ty] Wrote 0 files in 0.19 seconds (v3.1.2)
[11ty] Eleventy Fatal Error (CLI):
[11ty] 1. Problem creating an Eleventy Layout for the "./11ty-cat-pages.liquid" template file. (via EleventyBaseError)
[11ty] 2. You’re trying to use a layout that does not exist: _includes/base (via `layout: base`)
[11ty] 
[11ty] Original error stack trace: Error: You’re trying to use a layout that does not exist: _includes/base (via `layout: base`)
[11ty]     at TemplateLayoutPathResolver.getFullPath (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayoutPathResolver.js:115:10)
[11ty]     at new TemplateLayout (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayout.js:19:31)
[11ty]     at TemplateLayout.getTemplate (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateLayout.js:58:17)
[11ty]     at Template.getLayout (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/Template.js:187:26)
[11ty]     at #getData (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/Template.js:388:23)
[11ty]     at async TemplateMap.add (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateMap.js:70:14)
[11ty]     at async Promise.all (index 0)
[11ty]     at async TemplateWriter._addToTemplateMap (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:340:13)
[11ty]     at async TemplateWriter._createTemplateMap (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:351:3)
[11ty]     at async TemplateWriter.generateTemplates (file:///Users/johnwargo/dev/johnwargo/the-breakfast-quest-11ty/node_modules/@11ty/eleventy/src/TemplateWriter.js:382:3)
ERROR: "build:eleventy" exited with 1.

It took me a while to figure this out, but as I worked on the site, I renamed the site's eleventy.config.js file to .eleventy.js. Both are supported file names for the JavaScript file that controls the build process, so I didn't expect any problems.

As it turns out, I didn't do the rename correctly. When I renamed the file, I renamed the file to eleventy.js instead of .eleventy.js. Without the dot, 11ty couldn't find the configuration file.

The giveaway was the following line in the error message:

[11ty] 2. You’re trying to use a layout that does not exist: _includes/base (via `layout: base`)

in my site, I use the config file to instruct 11ty to look for layouts in the _layouts folder instead of the _includes folder (which is the default option).

	return {
		dir: {
			input: 'src',
			output: '_site',
			includes: '_includes',
			layouts: '_layouts',
			data: '_data'
		}
	}

The build process wasn't using the _layouts folder because it didn't know I wanted it to find the layouts in that folder -> because it wasn't able to find the configuration file that told it that.

Sigh, more wasted time troubleshooting a stupid developer mistake.


Previous Post: Delphi Method Hides Virtual Method

If this post helps you in some way, please consider buying me a coffee.