Troubleshooting and questions — Metuo HTML
Most problems in Metuo’s HTML edition come from a wrong number of ../ in a path, a class the stylesheet lacks, an
unchanged copy or an empty form endpoint.
The answers below cover those first (a copy is a section written into several pages, one of them left unchanged), then the questions buyers ask most.
Problems you may hit
Section titled “Problems you may hit”The page looks unstyled.
The browser can’t find assets/css/style.css. Pages inside a folder (blog/…, legal/…) link to it as
../assets/css/style.css; a page you moved or created may have the wrong number of ../. 404.html looks unstyled
when you open it from disk, and that’s expected: its paths start at the site’s root, which works on a host or with
npx serve . (Going live).
An image doesn’t appear.
Check the path in src against the file in assets/images/: spelling, extension, and ../ in pages inside a folder.
File names are case-sensitive on most hosts even when they are not on your computer: Home-Hero.JPG is not
home-hero.jpg.
A photo is cropped in the wrong place. Every photo fills a fixed frame and loses the edges the frame cuts, and the frames change shape between phone, tablet and desktop. Choose a photo with the subject near the middle, or crop it to the frame’s shape first (Editing the site).
A class I added does nothing.
assets/css/style.css only contains the classes the site already used. Rebuild it with npm run build:css
(Making it look like your brand).
The video doesn’t play.
The demo clips play from the Pexels CDN, so they need a connection, and a video plays only while it is on the screen.
Your own clip needs muted to play by itself, a path that matches the file (with ../ from a folder) and a format
browsers read (.mp4, H.264) (Editing the site).
I changed something, but another page still shows the old version. The pages hold copies, not references: the footer, the founder quote, the call to action, the prices, the questions, the booking form, the post cards, the services and the figures are written into each page that shows them (Editing the site). Search the folder for the old text.
The story card on Home shows the old text after the first story.
Its stories are written in the data-stories attribute, not in the card: change them there
(Editing the site). If the card stops turning, the list is no longer valid: an apostrophe or
a double quote in a text broke it (write them ' and \").
The header stays see-through, or white links sit on a light page.
A page that starts with a photo carries data-header-cover="true" on its first section and data-header-switch="true"
on the next one; the header turns solid when that section reaches the middle of the screen. Keep both marks, or remove
both on a page without a photo at the top (Editing the site).
The menu, the rows, the price switch or the bios stopped working.
assets/js/main.js or assets/js/config.js is missing, or an element lost a data-… attribute or an id when you
edited it (a row’s aria-controls must match its panel’s id, a team card’s button its bio’s). Open the browser’s
developer tools → Console for the error, and compare the markup with the same element on an untouched page.
The highlight under the header’s links is in the wrong place.
Each link is 75 px wide and carries data-menu-index, counting from 0 in the order of the menu; the highlight moves
by that number. Renumber the links after adding or moving one, and keep labels short enough for 75 px
(Editing the site).
The Journal shows only six posts.
That’s on purpose: more appear each time the visitor scrolls close to the spinner under the list, six at a time. If
they never do, the site script isn’t running (see above), or the spinner (data-load-spinner) was deleted.
The Journal shows more or fewer than six posts when the page opens.
The first page comes from the HTML as written: the first six cards carry class="min-w-0", every card from the seventh
on data-later class="hidden". Check the marks after you added or moved a card; from the first scroll on, the script
counts again (Editing the site).
Nothing moves: the hero, the scroll effects, the photo ticker. The visitor’s system (yours, if you see it) has “reduce motion” switched on, and the site honours it (Making it look like your brand).
The header and the hero don’t animate when I go back to Home. That’s on purpose: the opening plays when a visitor arrives or reloads the page, not when they move from page to page within the site.
The form says “Something went wrong”.
The form service rejected the submission or couldn’t be reached. Check formEndpoint in assets/js/config.js, then
open the developer tools → Network, submit again and read the service’s response. Web3Forms also needs
formAccessKey. Some services require you to confirm your email address before the first submission goes through.
The form shows “Thank you” but nothing arrives.
formEndpoint is empty, so the form is still in demo mode (the fields are logged in the browser console).
The form doesn’t send and the e-mail field turns red.
The e-mail is required and must look like an address; the message under it says so. Make other fields required, or
optional, with required (Forms).
Clicking a link downloads a file or shows a directory listing.
The link points at a folder or lacks .html. Links in this template always end in .html.
The share image or title is the old one.
Facebook, LinkedIn and X cache them. Use their debuggers to refresh, and check that the og:image URL uses your domain.
Questions
Section titled “Questions”Do I need Node.js or a build step? No, only to rebuild the stylesheet after changing the theme or using new classes. Everything else is editing HTML.
Can I use this template for a client? See License: that is the one place that answers it for your licence.
Can I remove the style guide, a page, a section or a video? Yes:
- the style guide: delete
style-guide.html; - a page: Editing the site;
- a section: delete its
<section>…</section>, for example the prices or the video; - the Testimonial or Journal page: delete it, its menu links and its sitemap line, and the buttons that lead to it (“Read full stories”, the post cards on Home).
Can I show prices in another currency, or hide them? Yes: the prices are text, written three times per plan (Editing the site). To hide them, delete the prices section on Home and Service.
Can the booking form book a time in my calendar?
It sends a request with the preferred date and time; it doesn’t check your availability. To book directly, link “Book
a session” to your Cal.com or Calendly page instead of contact.html (an outside link: add target="_blank" and
rel="noopener noreferrer"), or send the form to a webhook (Zapier, Make) that creates the event.
Can I change the fonts to my brand’s? Yes: Making it look like your brand.
Can I write the site in another language?
Yes: write the text in your language and set lang="en" on each page’s <html> and og:locale (en_US) in its
<head>. The posts’ dates are written as text, so write them your way (keep the datetime as 2026-05-28). The
template has no language switch.
Does the site need JavaScript?
For what moves and for the interactive parts: assets/js/main.js runs the header and the phone menu, the rows, the
price switch, the story card, the lit lists, the scroll effects, the journal’s loading, the bios, the videos and the
form. Without it, every text, every post card and the hero’s opening still show, but the phone menu, the rows and the
bios don’t open, the prices stay monthly, the videos don’t play and the form can’t send. Every word and link is in the
HTML, so search engines read the whole site.
Does the site need a cookie banner? As shipped, the template sets no cookies and loads no third-party scripts: the font is served from your own domain. The demo videos come from the Pexels CDN until you replace them. Any analytics you add is yours to declare.
Can I use it with WordPress, Webflow or a site builder?
Not directly: it is plain HTML and CSS. You can paste sections into a builder that accepts custom HTML, but the
interactions rely on assets/js/main.js.
Can I connect a CMS? See Editing without touching HTML for the options, including the Astro and Next.js editions built for one.
How do I update to a new version of the template?
CHANGELOG.md in the new release lists what changed. For a script or style fix, replacing assets/js/main.js and
assets/css/style.css is usually enough (run npm run build:css again if you added classes of your own or changed the
theme). Page changes are listed so you can apply them to your edited pages.
Can you customise it for me, or build my site? Yes. Marcframe, the studio behind this template, updates templates to your needs (brand, content, new pages and features), builds custom templates and designs new websites. Get in touch at marcframe.com/contact or hire us on Contra.
Something is broken and none of this helps. Support and updates: https://framebrick.co/support. Send the page, the browser, and the error text or a screenshot: it makes the answer much faster.