Skip to content
Sign inJoin waitlist

Troubleshooting — Fitbricks HTML

Most problems with the Fitbricks HTML template come from a path that doesn’t match a file, a class missing from the stylesheet or a form endpoint not set. Those answers come first.

Then come the questions buyers ask most.

An image does not appear. The src must match the file in assets/images/: same spelling, same extension, same capitals (servers care even when your computer doesn’t). In pages inside a folder (program/, club/, blog/ and the others) the path starts with ../; in 404.html it starts with / (Editing the site).

A photo is cropped in the wrong place. Every photo sits in a frame and is cropped to fill it from the centre, and the frames change shape between phone, tablet and desktop (a program photo is a card on Programs and a wide cover on its page). Keep the subject in the middle.

A class I added does nothing. assets/css/style.css holds only the classes the pages used when it was built. Rebuild it: npm install once, then npm run build:css (Making it look like your brand).

The page looks unstyled on the host but fine on my computer. assets/ wasn’t uploaded, or not to the same folder as the pages. Upload the whole folder, keeping its structure.

The 404 page looks unstyled. Its paths start at the site’s root (/assets/…). If the site lives in a sub-folder of its domain, add the folder to those paths (Going live).

A form says “Something went wrong”. The service refused the request: check formEndpoint (and formAccessKey for Web3Forms) in assets/js/config.js, that the form exists at the service and accepts your domain. Open the browser’s console for the service’s answer.

A form says “Thank you” but nothing arrives. With formEndpoint empty the forms run in demo mode: nothing is sent, and the fields go to the browser console. Set an endpoint (Forms). If you added a field named fax, rename it: that name is the hidden spam trap.

A form won’t send. The e-mail is required on every form, and “Contact Time Preferences” on the contact and free-trial forms: the browser asks for them before sending. Remove required from the <input> or <select> to make one optional (Forms).

Programs, Clubs, Trainers or Blog show only some cards. They show more each time the end of the list comes into view; scroll down. Visitors without JavaScript see them all. Change the step in data-page-size on the list.

A new club or program shows on its page but nowhere else. Lists are written out in the HTML, so an item appears only where you put its card (Editing the site). Search the folder for the file name of a similar item to find the lists to update.

A card is missing in a list, or shows on desktop but not on phones. In the lists that load on scroll, data-later and the class of each <li> belong to its place in the list. After adding or removing a card, check that the first cards are the ones without data-later (Editing the site).

The hero title, a quote or a member’s story shows old text after I changed it. Home writes these more than once: the title and lead word by word plus a whole copy, the quotes in data-quotes, the stories in the ticker and the carousel (Editing the site).

A program’s video shows another video, or nothing. The video’s id is in two places, data-embed and the poster’s src: change both (Editing the site). Some videos can’t be embedded on other sites; their owners decide that on YouTube.

A link leads to the 404 page. The href must match the file: club/my-club.html from the root, ../club/my-club.html from a page in a folder. Search the folder for the old file name after renaming or removing a page.

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: tags carry your domain.

The quote photos don’t slide, or the ticker stands still. 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 quotes still change and the carousel’s arrows still work.

Can I use this template for a client? See License: that is the one place that answers it for your licence.

Are the legal pages ready to use? No. The Privacy Policy and the Terms & Conditions are samples written for the made-up Waras gym, and the Terms hold a placeholder, [Your Country/State]. Have texts written for your business and checked for your country before you publish (Editing the site).

Can I keep the program videos? No: they are other creators’ YouTube videos, embedded as examples of the layout. Put your own videos in their place, or remove the video block (Editing the site).

Who is Waras? A made-up gym that fills the demo: its logo, name, e-mails, phones and addresses are placeholders. Put your own in their place (Editing the site).

Can I remove the style guide, a whole page or a section? Yes: delete style-guide.html; for a page see Editing the site; for a section, delete its <section>…</section> inside <main>.

Can I change the fonts to my brand’s? Yes: Making it look like your brand.

Do I need a CMS? No. Content is in the pages. If someone who doesn’t write HTML will publish, or you change programs and clubs often, see Editing without touching HTML.

Does the booking form book a class? No: it sends the request (the club, the date, the time and the visitor’s details) to the service you connect; you confirm it with the visitor yourself, or route it to your booking tool with a webhook (Forms).

Can I write the site in another language? Yes: translate the text in the pages, set lang="en" on <html> and og:locale to yours in every page (find and replace in files), and write the dates in your format.

Does the site need a cookie banner? As shipped, the template sets no cookies of its own and the font is served from your own domain. The program pages load their video’s poster from YouTube’s image server, and the player, from youtube-nocookie.com, only when the visitor presses play. The form service you choose receives what visitors type: name both in your Privacy Policy. Any analytics you add are yours to declare.

How do I update to a new version of the template? CHANGELOG.md lists what changed. Copy the changed parts into your pages, or move your text and images into the new release.

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.