# Support **URL:** https://zola.discourse.group/c/support/5.md [Latest](https://zola.discourse.group/latest.md) · [Categories](https://zola.discourse.group/categories.md) --- ## [About the Support category](https://zola.discourse.group/t/about-the-support-category/11)
**Author:** [@keats](https://zola.discourse.group/u/keats)\ **Replies:** 0
This is the place to ask questions/help on how to use Zola. Make sure to give all the information needed in your post, having a post only saying “Pagination doesn’t work” without details is unlikely to get a response. --- ## [Convert to Tera v2](https://zola.discourse.group/t/convert-to-tera-v2/2980)
**Author:** [@Geobomatic](https://zola.discourse.group/u/Geobomatic)\ **Replies:** 2\ **Last updated:** [September 13, 2026, 7:00pm UTC](https://zola.discourse.group/t/convert-to-tera-v2/2980 "2026-09-13T19:00:51Z")
I have this WIP conversion: {% component print\_tags(page) %} {% set tags = \[\] %} {% for t in page.taxonomies\["tags"\] %} {% set s = t | slugify %} {% set expanded\_obj = '{ "slug": "' ~ s ~ '", "tag": "' ~ t ~ '" }' %} {%… --- ## [How works components?](https://zola.discourse.group/t/how-works-components/2979)
**Author:** [@krshk](https://zola.discourse.group/u/krshk)\ **Replies:** 0\ **Last updated:** [September 8, 2026, 8:27am UTC](https://zola.discourse.group/t/how-works-components/2979 "2026-09-08T08:27:08Z")
Hi. I discovered via this forum that shortcodes and macros had been replaced with components. (I use the 0.23.3 version on GNU/Linux Void Linux) But on the main documentation ( Redirect ), I didn’t find any explanation … --- ## [Closest equiv of img() shortcode using components?](https://zola.discourse.group/t/closest-equiv-of-img-shortcode-using-components/2978)
**Author:** [@penryu](https://zola.discourse.group/u/penryu)\ **Replies:** 3\ **Last updated:** [September 5, 2026, 12:13pm UTC](https://zola.discourse.group/t/closest-equiv-of-img-shortcode-using-components/2978 "2026-09-05T12:13:14Z")
I just upgraded from 0.22 to 0.23 and I’m noticing that the shortcodes are gone in favor of Tera components, and I’m totally on board with the change! I looked through the docs and the other posts in the forum, and I mi… --- ## [How to set up easy inclusion of an HTML snippet?](https://zola.discourse.group/t/how-to-set-up-easy-inclusion-of-an-html-snippet/2976)
**Author:** [@jakob](https://zola.discourse.group/u/jakob)\ **Replies:** 3\ **Last updated:** [August 31, 2026, 2:45pm UTC](https://zola.discourse.group/t/how-to-set-up-easy-inclusion-of-an-html-snippet/2976 "2026-08-31T14:45:33Z")
I’m trying to set up Zola to enable me to repeatedly include little bits of HTML (e.g. \blue\). I thought maybe I could define these as variables and then use {{ blue\_tag | safe }} in my Markd… --- ## [Compenent objects](https://zola.discourse.group/t/compenent-objects/2974)
**Author:** [@charlie137](https://zola.discourse.group/u/charlie137)\ **Replies:** 1\ **Last updated:** [August 27, 2026, 3:54pm UTC](https://zola.discourse.group/t/compenent-objects/2974 "2026-08-27T15:54:29Z")
New syntax forces me to pass internal objects to components now: {{ \ }} Is there a way around? --- ## [Getting invocation count in components](https://zola.discourse.group/t/getting-invocation-count-in-components/2971)
**Author:** [@ysfchn](https://zola.discourse.group/u/ysfchn)\ **Replies:** 1\ **Last updated:** [August 22, 2026, 2:50pm UTC](https://zola.discourse.group/t/getting-invocation-count-in-components/2971 "2026-08-22T14:50:30Z")
I’m trying to migrate stuff to Tera v2 and noticed I cannot seem to get the invocation count using nth variable. I’ve looked at the docs and found nothing about it, and doesn’t seem it is exposed to component global vari… --- ## [Migrating theme to v0.23.2 'Variable page is not defined'](https://zola.discourse.group/t/migrating-theme-to-v0-23-2-variable-page-is-not-defined/2963)
**Author:** [@hyperreal](https://zola.discourse.group/u/hyperreal)\ **Replies:** 5\ **Last updated:** [August 21, 2026, 10:49pm UTC](https://zola.discourse.group/t/migrating-theme-to-v0-23-2-variable-page-is-not-defined/2963 "2026-08-21T22:49:59Z")
I’m trying to migrate a theme to Zola v0.23.2. I’m new to this so I’m not quite sure how to debug the issue I’m having. When I try to build the site with zola build, I get the following error: Variable page is not define… --- ## [Where should I put component definitions in Zola 0.23?](https://zola.discourse.group/t/where-should-i-put-component-definitions-in-zola-0-23/2957)
**Author:** [@Rratic](https://zola.discourse.group/u/Rratic)\ **Replies:** 16\ **Last updated:** [August 13, 2026, 8:09am UTC](https://zola.discourse.group/t/where-should-i-put-component-definitions-in-zola-0-23/2957 "2026-08-13T08:09:15Z")
I used to put shortcodes under templates/shortcodes, but putting component definitions there doesn’t work. I tried templates/components but still doesn’t work. It’s not mentioned at all in documentation and I can’t find … --- ## [Link to a random paragraph/line anchor in one markdown page](https://zola.discourse.group/t/link-to-a-random-paragraph-line-anchor-in-one-markdown-page/2962)
**Author:** [@gluiz1](https://zola.discourse.group/u/gluiz1)\ **Replies:** 4\ **Last updated:** [August 13, 2026, 5:45am UTC](https://zola.discourse.group/t/link-to-a-random-paragraph-line-anchor-in-one-markdown-page/2962 "2026-08-13T05:45:42Z")
I want to be able to link to specific paragraphs (or lines) inside a page (markdown file). In obsidian, you can use the mark ^, for example: My paragraph here ^anchor And you link to specific syntax by the Obsidian w… --- ## [CSS for new syntax highlighter - really necessary?](https://zola.discourse.group/t/css-for-new-syntax-highlighter-really-necessary/2965)
**Author:** [@mrec](https://zola.discourse.group/u/mrec)\ **Replies:** 1\ **Last updated:** [August 11, 2026, 7:44pm UTC](https://zola.discourse.group/t/css-for-new-syntax-highlighter-really-necessary/2965 "2026-08-11T19:44:47Z")
I had to tweak the blog recently and ran into the syntax highlighting breaking change in 22.1. The docs at Syntax Highlighting | Zola say you will need to add the following CSS to your site CSS for things to display co… --- ## [How to fix escape issue in KaTeX support?](https://zola.discourse.group/t/how-to-fix-escape-issue-in-katex-support/2956)
**Author:** [@Rratic](https://zola.discourse.group/u/Rratic)\ **Replies:** 3\ **Last updated:** [August 10, 2026, 1:04pm UTC](https://zola.discourse.group/t/how-to-fix-escape-issue-in-katex-support/2956 "2026-08-10T13:04:03Z")
Currently when I use themes that support KaTeX, there’s a disturbing issue that, when I wish to put \\{, I have to use \\\\{. The same goes for \\}, \\, and \\\\ (and maybe some else I haven’t found yet). I guess the problem … --- ## [Is it possible to have version 0.22 available on Homebrew?](https://zola.discourse.group/t/is-it-possible-to-have-version-0-22-available-on-homebrew/2955)
**Author:** [@asibahi](https://zola.discourse.group/u/asibahi)\ **Replies:** 3\ **Last updated:** [August 7, 2026, 6:53am UTC](https://zola.discourse.group/t/is-it-possible-to-have-version-0-22-available-on-homebrew/2955 "2026-08-07T06:53:48Z")
Hello. I upgraded the zola version today and my website stopped building. There are more breaking changes than I can work through right now and since brew upgraded it lost the older version, and I cannot figure out how … --- ## [\_index front matter and Tera's ternary operator and optional chaining](https://zola.discourse.group/t/index-front-matter-and-teras-ternary-operator-and-optional-chaining/2950)
**Author:** [@videbar](https://zola.discourse.group/u/videbar)\ **Replies:** 3\ **Last updated:** [July 19, 2026, 12:07pm UTC](https://zola.discourse.group/t/index-front-matter-and-teras-ternary-operator-and-optional-chaining/2950 "2026-07-19T12:07:25Z")
Hi everyone, I’m trying to build a Tera template such that it attempts to read some \[extra\] fields from \_index.md and use some default values if those fields don’t exist. I’ve tried to do this using Tera’s optional chain… --- ## [Getting the last digit of a number](https://zola.discourse.group/t/getting-the-last-digit-of-a-number/2944)
**Author:** [@matthillco](https://zola.discourse.group/u/matthillco)\ **Replies:** 3\ **Last updated:** [June 7, 2026, 9:22pm UTC](https://zola.discourse.group/t/getting-the-last-digit-of-a-number/2944 "2026-06-07T21:22:19Z")
I do this arcane thing to get the last digit of an integer, which seems a bit… long. Is there an easier way that I’ve missed? {% set num\_last = number | as\_str | split(pat="") | slice(start=-2, end=-1) | join(sep="") | … --- ## [Mirroring Atom feed to a different URL to support legacy clients](https://zola.discourse.group/t/mirroring-atom-feed-to-a-different-url-to-support-legacy-clients/2938)
**Author:** [@mk47685967](https://zola.discourse.group/u/mk47685967)\ **Replies:** 2\ **Last updated:** [May 4, 2026, 11:08am UTC](https://zola.discourse.group/t/mirroring-atom-feed-to-a-different-url-to-support-legacy-clients/2938 "2026-05-04T11:08:32Z")
I am in the process of migrating a Pelican site to Zola. By convention, the main RSS feed generated by Pelican has the URL example.com/feeds/all.atom.xml. With my Zola configuration, the feed lives at example.com/feed.xm… --- ## [How to hide section slug in url](https://zola.discourse.group/t/how-to-hide-section-slug-in-url/2472)
**Author:** [@wangjiaxiang](https://zola.discourse.group/u/wangjiaxiang)\ **Replies:** 14\ **Last updated:** [April 28, 2026, 9:49am UTC](https://zola.discourse.group/t/how-to-hide-section-slug-in-url/2472 "2026-04-28T09:49:28Z")
I have folder structure like below ├── content │ ├── \_index.md │ ├── section1 │ │ ├── \_index.md │ │ ├── post1 │ │ │ ├── index.md I want the url of post1 to be /post1 instead of /section1/post1. Is th… --- ## [Building Nav without defining entries in the config file](https://zola.discourse.group/t/building-nav-without-defining-entries-in-the-config-file/2932)
**Author:** [@plummmm](https://zola.discourse.group/u/plummmm)\ **Replies:** 8\ **Last updated:** [April 28, 2026, 9:22am UTC](https://zola.discourse.group/t/building-nav-without-defining-entries-in-the-config-file/2932 "2026-04-28T09:22:55Z")
I’m writing a template and I’d like to loop over the folders/sections on my top level to generate the entries in my nav. I’m not actually sure if this is possible, because every template I look at seems to have them ente… --- ## [Rendering anchors for markdown in templates?](https://zola.discourse.group/t/rendering-anchors-for-markdown-in-templates/2918)
**Author:** [@matthillco](https://zola.discourse.group/u/matthillco)\ **Replies:** 1\ **Last updated:** [March 19, 2026, 9:39pm UTC](https://zola.discourse.group/t/rendering-anchors-for-markdown-in-templates/2918 "2026-03-19T21:39:32Z")
I’ve got this pattern for rendering some specific headings in templates: {{ “## Summary” | markdown | safe }} It works fine, but does not render either the built in anchor, or my custom one in a modified anchor-link.ht… --- ## [Issues with static js file](https://zola.discourse.group/t/issues-with-static-js-file/2917)
**Author:** [@heitorpb](https://zola.discourse.group/u/heitorpb)\ **Replies:** 1\ **Last updated:** [March 19, 2026, 3:58pm UTC](https://zola.discourse.group/t/issues-with-static-js-file/2917 "2026-03-19T15:58:31Z")
Hello, I just discovered this nice project called Wander and decided to give it a try in my blog. I added these new files: static/ └── wander ├── index.html └── wander.js And zola build gets them an put in my… --- ## [Building a multilingual travel guide site with Zola: Practical tips from a real project](https://zola.discourse.group/t/building-a-multilingual-travel-guide-site-with-zola-practical-tips-from-a-real-project/2911)
**Author:** [@chenlanlan](https://zola.discourse.group/u/chenlanlan)\ **Replies:** 0\ **Last updated:** [March 5, 2026, 7:51am UTC](https://zola.discourse.group/t/building-a-multilingual-travel-guide-site-with-zola-practical-tips-from-a-real-project/2911 "2026-03-05T07:51:29Z")
Hey Zola folks, I’ve been running Zola in production for the past 8–9 months on a couple of sites, one of which is a bit unusual for typical SSG use: a detailed guide to daytime yacht cruises in Dubai (routes, realistic… --- ## [Sorting associative arrays?](https://zola.discourse.group/t/sorting-associative-arrays/2907)
**Author:** [@BezPowell](https://zola.discourse.group/u/BezPowell)\ **Replies:** 3\ **Last updated:** [February 24, 2026, 3:54pm UTC](https://zola.discourse.group/t/sorting-associative-arrays/2907 "2026-02-24T15:54:26Z")
This is a question mainly to do with Tera, but could be relevant to Zola as well if the required functionality could be added there. I’ve got a macro I use in multiple websites to build a little ‘metadata’ section on pa… --- ## [How to keep giallo from rewriting unknown langs to "plain"](https://zola.discourse.group/t/how-to-keep-giallo-from-rewriting-unknown-langs-to-plain/2906)
**Author:** [@penryu](https://zola.discourse.group/u/penryu)\ **Replies:** 2\ **Last updated:** [February 20, 2026, 2:03pm UTC](https://zola.discourse.group/t/how-to-keep-giallo-from-rewriting-unknown-langs-to-plain/2906 "2026-02-20T14:03:04Z")
Background I use a third-party library Klipse (link below) to augment code blocks for some languages, usually JavaScript and Clojure. It uses CSS selectors to find specific code blocks in a page and attaching dynamic lo… --- ## [Here is a debuging macro to view easy to read \`\_\_tera\_context\`](https://zola.discourse.group/t/here-is-a-debuging-macro-to-view-easy-to-read-tera-context/2409)
**Author:** [@ShawnPConroy](https://zola.discourse.group/u/ShawnPConroy)\ **Replies:** 3\ **Last updated:** [February 19, 2026, 11:32pm UTC](https://zola.discourse.group/t/here-is-a-debuging-macro-to-view-easy-to-read-tera-context/2409 "2026-02-19T23:32:04Z")
I created a short script that displays the same stuff as {{ \_\_tera\_context }}, but each variable is in it’s own accordion \ element. It also put page content and sub-pages in their own \. It’s easier to q… --- ## [Some pages blank](https://zola.discourse.group/t/some-pages-blank/2900)
**Author:** [@akhirsch](https://zola.discourse.group/u/akhirsch)\ **Replies:** 7\ **Last updated:** [January 28, 2026, 9:34pm UTC](https://zola.discourse.group/t/some-pages-blank/2900 "2026-01-28T21:34:58Z")
Hey all, I keep having a problem where some of my pages end up blank for seemingly no reason. It seems random, but consistent, even when I rebuild from scratch. For instance, this page: +++ title = "Choret: Choreograph… --- ## [Haproxy, Nginx and theme Deepthought giving a 301](https://zola.discourse.group/t/haproxy-nginx-and-theme-deepthought-giving-a-301/2892)
**Author:** [@jradxl](https://zola.discourse.group/u/jradxl)\ **Replies:** 3\ **Last updated:** [January 10, 2026, 6:29pm UTC](https://zola.discourse.group/t/haproxy-nginx-and-theme-deepthought-giving-a-301/2892 "2026-01-10T18:29:10Z")
I’m using Zola for the first time where I am deploying using Nginx behind a Haproxy reverse proxy. I’m using the Deepthought theme as a result of watching the Jamstack YouTube videos. My site works fine via zola serve … --- ## [What is this theme?](https://zola.discourse.group/t/what-is-this-theme/2886)
**Author:** [@V8Original](https://zola.discourse.group/u/V8Original)\ **Replies:** 1\ **Last updated:** [December 18, 2025, 4:29pm UTC](https://zola.discourse.group/t/what-is-this-theme/2886 "2025-12-18T16:29:12Z")
I’m currently considering using Zola to create a simple website for myself. I’ve been looking over examples and I came across this here which I really like the look and feel of. I looked through the zola themes but could… --- ## [Skipping pages from a section in the paginator](https://zola.discourse.group/t/skipping-pages-from-a-section-in-the-paginator/1265)
**Author:** [@ghlecl](https://zola.discourse.group/u/ghlecl)\ **Replies:** 5\ **Last updated:** [November 21, 2025, 9:44am UTC](https://zola.discourse.group/t/skipping-pages-from-a-section-in-the-paginator/1265 "2025-11-21T09:44:42Z")
Hello. I am porting a site from Hugo to Zola. I am thus writing a cut down, much simpler version of the theme I used with only the features I need. I have come across a problem with the pagination and was wondering if… --- ## [Custom path for taxonomy pages?](https://zola.discourse.group/t/custom-path-for-taxonomy-pages/82)
**Author:** [@danielw](https://zola.discourse.group/u/danielw)\ **Replies:** 5\ **Last updated:** [October 6, 2025, 1:50pm UTC](https://zola.discourse.group/t/custom-path-for-taxonomy-pages/82 "2025-10-06T13:50:01Z")
Hey there, first of all, thanks a lot for all the work you put into Zola. It’s an extremely enjoyable experience to work with it. :slight\_smile: I have a question about using the taxonomies feature, though. I am curren… --- ## [Theme is not used](https://zola.discourse.group/t/theme-is-not-used/2862)
**Author:** [@fschwa](https://zola.discourse.group/u/fschwa)\ **Replies:** 3\ **Last updated:** [September 25, 2025, 8:02pm UTC](https://zola.discourse.group/t/theme-is-not-used/2862 "2025-09-25T20:02:12Z")
Hi, the theme I am trying to use, is not applied. I started following the instructions on Overview | Zola and wanted to add a theme afterwards. I have it copied to the themes folder and its folder name is set with the… [Next page](https://zola.discourse.group/c/support/5.md?page=1)