Meta-tags extension loading even if not included (and causing issues in admin mode) #101

jbaf · 2025-10-13T08:00:08Z

jbaf
Oct 13, 2025

I'm trying to use v2 alpha for the first time but I'm facing an issue with the meta-tags extension in admin mode.

In my page, my first  tag is @{ heroSubtitle } line, in admin mode, it messes up with the code of my page because I guess the meta-tags extension looks for the first paragraph in my page and uses the found element as meta description, thus resulting in that... "abomination" :

<meta name="description" content="<am-inpage-edit
	dashboard="/dashboard"
	context="/"
	field="heroSubtitle"
	page="/"
	label="Edit"
>

...and messing up the entire <head> structure because of the admin mode's additional tags (forcing it to close too soon, to open the <body> early, and so on).

As much as I liked the elegance of that extension and would have liked to use it properly, I tried to remove the inclusion of the meta-tags extension in my template files to deal with meta myself, but even that way, the extension continues to load and generate the meta tags on top of my page. I get that it is probably an composer autoload issue, but I'm not so used to work with composer, so I don't know how to get passed it. I even tried to composer remove automad/standard-v1 and composer remove automad/meta-tags but no luck... Meta are still automatically generated at the top of my <head> when it should not. Here' my code, for reference (it looks almost exactly like the automad/standard one) :

<!DOCTYPE html>
<html lang="fr" class="@{ theme | sanitize }">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">
  <title>@{ metaTitle | def('@{ sitename } / @{ title | def ("404") }') }</title>
	<@ elements/favicons.php @>
	<# 
	
	To make sure the following variables are always available in the dashboard, 
	they can be included in a comment block.
	
	@{ imageCard } 
	@{ checkboxHideThumbnails }
	
	#>
	<@ elements/styles.php @>
	@{ itemsHeader }
</head>

The only workaround I found was to put a static HTML commented  at the top of my <body> so that becomes the first paragraph and leaves me alone... But that's not a viable solution in production.

Would you (or anyone else) have a proper solution for this issue, preferably to make the extension work as expected, but even if it means disabling the extension and doing the meta part myself ?

Thank you in advance !

marcantondahmen · 2025-10-13T08:43:07Z

marcantondahmen
Oct 13, 2025
Maintainer

Hi, the meta tags extension is not compatible with version 2 and should not be used in new sites anymore. All its functionality is implemented in version 2 out of the box.

That also includes the option to dynamically create open-graph images if no image is defined explicitly.

So you can safely remove the extension.

5 replies

jbaf Oct 13, 2025
Author

OK ! That explains why removing it from my code and from my files tree does not get rid of the meta automatic generation.

Still, the main issue remains. I mean the issue with the first 's content being taken as the default meta-description, and, in the case of a dynamic paragraph, imported in the attribute with all the tags it contains in admin mode (see my original message). Do you have any idea of a solution or a proper workaround to avoid this ?

<meta name="description" content="<am-inpage-edit
	dashboard="/dashboard"
	context="/"
	field="heroSubtitle"
	page="/"
	label="Edit"
>

marcantondahmen Oct 13, 2025
Maintainer

How does the entire template file look like? All fields in the head element should be ignored by the UI.

jbaf Oct 13, 2025
Author

I'm not quite sure what you mean by that but my template file looks like this, for now:

<!DOCTYPE html>
<html lang="fr" class="@{ theme | sanitize }">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">
  <title>@{ metaTitle | def('@{ sitename } / @{ title | def ("404") }') }</title>
	<@ elements/favicons.php @>
	<# 
	
	To make sure the following variables are always available in the dashboard, 
	they can be included in a comment block.
	
	@{ imageCard } 
	@{ checkboxHideThumbnails }
	
	#>
	<@ elements/styles.php @>
	@{ itemsHeader }
</head>

<body class="@{ :template | def(@{ template }) | sanitize }">
	<div class="siteContainer">
		<@ elements/header.php @>
		<main class="pageContent">

		<section class="section homeHero">
			<div class="container-large">
				<div class="flex-grid flex-grid--align-center gx-4">
					<div class="col-12 col-6@sm homeHero-title">
						<h1 class="displayTitle">@{ heroTitle }</h1>
						<p class="lead mt-1">@{ heroSubtitle }</p>
					</div>	
					<div class="col-12 col-6@sm">
					</div>
				</div>
			</div>
		    </section>
          <@ elements/footer.php @>
          </main>
	</div>

	<@ elements/scripts.php @>
</body>
</html>

marcantondahmen Oct 17, 2025
Maintainer

Thanks, I will try to take a look into this asap.

jbaf Oct 18, 2025
Author

Great, thank you !

For reference (but obviously) this only happens when the meta description is auto-generated.
I eventually bypassed this issue by manually setting a meta description for my page in the admin UI, so the findFirstParagraph method is not applied wrongfully.

This could still be a problem in a blog post context though, where a user would expect the description to be generated from the post's content.

Thanks again !

Automad

Meta-tags extension loading even if not included (and causing issues in admin mode) #101

Uh oh!

Uh oh!

jbaf Oct 13, 2025

Replies: 1 comment · 5 replies

Uh oh!

marcantondahmen Oct 13, 2025 Maintainer

Uh oh!

Uh oh!

jbaf Oct 13, 2025 Author

Uh oh!

marcantondahmen Oct 13, 2025 Maintainer

Uh oh!

Uh oh!

jbaf Oct 13, 2025 Author

Uh oh!

marcantondahmen Oct 17, 2025 Maintainer

Uh oh!

jbaf Oct 18, 2025 Author

jbaf
Oct 13, 2025

Replies: 1 comment 5 replies

marcantondahmen
Oct 13, 2025
Maintainer

jbaf Oct 13, 2025
Author

marcantondahmen Oct 13, 2025
Maintainer

jbaf Oct 13, 2025
Author

marcantondahmen Oct 17, 2025
Maintainer

jbaf Oct 18, 2025
Author