Skip to content
Sign inJoin waitlist

Troubleshooting and questions — Kendi HTML

Most problems with the Kendi 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 (blog/, category/, author/, legal/) 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 post cover is wide on a card and tall on a hero slide). 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.

The contact form’s button stays faded. It is faded until every required field is filled, as in the original design. It still works once they are.

Articles shows only six posts. It shows six 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 in blog.html.

A new post shows on its page but nowhere else. Lists are written out in the HTML, so a post appears only where you put its card (Editing the site). Search the folder for the file name of a post of the same category and date to find the lists to update.

A post appears twice, or a list has one card too many. After adding a card, the lists that show a fixed number (the slideshow, Latest posts, the Spotlights, the newsletter band, Related Post, the previews of Categories and Authors) need their oldest card removed.

A slide shows old text after I changed it. The slideshows hold copies of their slides for the endless loop (inert, aria-hidden="true"): change every copy (Editing the site).

A link leads to the 404 page. The href must match the file: blog/my-post.html from the root, ../blog/my-post.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 slideshows don’t turn by themselves. 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 arrows and dots 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 Terms of Service and the Privacy Policy are generic samples with placeholders such as [Your Company Name] and [URL]. Fill in every placeholder and have the texts checked for your site and country before you publish (Editing the site).

What is the sponsored ad, and can I remove it? A slot for an advertiser on Home and in the sidebar, filled with a made-up one (Tenq Tech) whose “Learn more” leads to your Contact page. Put your own ad in its place, or delete its block (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 publish often, see Editing without touching HTML.

Does the newsletter send emails? No: it collects sign-ups and hands them to the service you connect; you write and send the newsletter in your newsletter tool (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 form service you choose receives what visitors type: name it 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.