Flask raises TemplateNotFound error even though template file exists

Question

I am trying to render the file home html   The file exists in my project  but I keep getting jinja2 exceptions TemplateNotFound  home html when I try to render it   Why can t Flask find my template   from flask import Flask  render template  app   Flask   name      app route      def home        return render template  home html        myproject     app py     home html

User · Answer

If you run your code from an installed package, make sure template files are present in directory <python root>/lib/site-packages/your-package/templates.

Some details:

In my case I was trying to run examples of project flask_simple_ui and jinja would always say

jinja2.exceptions.TemplateNotFound: form.html

The trick was that sample program would import installed package flask_simple_ui. And ninja being used from inside that package is using as root directory for lookup the package path, in my case ...python/lib/site-packages/flask_simple_ui, instead of os.getcwd() as one would expect.

To my bad luck, setup.py has a bug and doesn't copy any html files, including the missing form.html. Once I fixed setup.py, the problem with TemplateNotFound vanished.

I hope it helps someone.

User · Answer

Another explanation I ve figured out for myself When you create the Flask application  the folder where templates is looked for is the folder of the application according to name you ve provided to Flask constructor  app   Flask   name     The   name   here is the name of the module where application is running  So the appropriate folder will become the root one for folders search  projects      yourproject          app              templates   So if you provide instead some random name the root folder for the search will be current folder

User · Answer

I think Flask uses the directory templates by default  So your code should be like this suppose this is your hello py from flask import Flask render template  app Flask   name   template folder  template      app route  quot   quot   def home        return render template  home html     app route  quot  about  quot   def about        return render template  about html    if   name     quot   main   quot       app run debug True   And you work space structure like project      hello py             template           home html          about html         static             js               main js            css                 main css  also you have create two html files with name of home html and about html and put those files in templates folder

User · Answer

You need to put all you  html files in the template folder next to your python module  And if there are any images that you are using in your html files then you need put all your files in the folder named static   In the following Structure  project      hello py     static          image jpg         style css     templates          homepage html     virtual          filename json

User · Answer

You must create your template files in the correct location  in the templates subdirectory next to the python module     the module where you create your Flask app   The error indicates that there is no home html file in the templates  directory  Make sure you created that directory in the same directory as your python module  and that you did in fact put a home html file in that subdirectory   If your app is a package  the templates folder should be created inside the package  myproject      app py     templates          home html   myproject      mypackage            init   py         templates              home html  Alternatively  if you named your templates folder something other than templates and don t want to rename it to the default  you can tell Flask to use that other directory  app   Flask   name    template folder  template      still relative to module  You can ask Flask to explain how it tried to find a given template  by setting the EXPLAIN TEMPLATE LOADING option to True  For every template loaded  you ll get a report logged to the Flask app logger  at level INFO  This is what it looks like when a search is successful  in this example the foo bar html template extends the base html template  so there are two searches   2019-06-15 16 03 39 197  INFO in debughelpers  Locating template  quot foo bar html quot       1  trying loader of application  quot flaskpackagename quot         class  jinja2 loaders FileSystemLoader        encoding   utf-8         followlinks  False        searchpath           -      project flaskpackagename templates        - gt  found        project flaskpackagename templates foo bar html    2019-06-15 16 03 39 203  INFO in debughelpers  Locating template  quot base html quot       1  trying loader of application  quot flaskpackagename quot         class  jinja2 loaders FileSystemLoader        encoding   utf-8         followlinks  False        searchpath           -      project flaskpackagename templates        - gt  found        project flaskpackagename templates base html    Blueprints can register their own template directories too  but this is not a requirement if you are using blueprints to make it easier to split a larger project across logical units  The main Flask app template directory is always searched first even when using additional paths per blueprint

User · Answer

Check that    the template file has the right name the template file is in a subdirectory called templates the name you pass to render template is relative to the template directory  index html would be directly in the templates directory  auth login html would be under the auth directory in the templates directory   you either do not have a subdirectory with the same name as your app  or the templates directory is inside that subdir    If that doesn t work  turn on debugging  app debug   True  which might help figure out what s wrong

User · Answer

Please note that the above accepted Answer provided for file project structure is absolutely correct     Also    In addition to properly setting up the project file structure  we have to tell flask to look in the appropriate level of the directory hierarchy   for example        app   Flask   name    template folder     templates         app   Flask   name    template folder     templates   static folder     static     Starting with     moves one directory backwards and starts there   Starting with        moves two directories backwards and starts there  and so on       Hope this helps

User · Answer

I had the same error turns out the only thing i did wrong was to name my  templates  folder  template  without  s   After changing that it worked fine dont know why its a thing but it is

User · Answer

I don t know why  but I had to use the following folder structure instead  I put  templates  one level up   project      app          hello py         static              main css     templates          home html     venv    This probably indicates a misconfiguration elsewhere  but I couldn t figure out what that was and this worked

User · Answer

Another alternative is to set the root path which fixes the problem both for templates and static folders    root path   Path sys executable  parent if getattr sys   frozen   False  else Path   file    parent app   Flask   name   split      0   root path root path    If you render templates directly via Jinja2  then you write   ENV   jinja2 Environment loader jinja2 FileSystemLoader str root path    templates     template   ENV get template your template name

User · Answer

My problem was that the file I was referencing from inside my home html was a  j2 instead of a  html  and when I changed it back jinja could read it  Stupid error but it might help someone

User · Answer

When render template   function is used it tries to search for template in the folder called templates and it throws error jinja2 exceptions TemplateNotFound when     the html file do not exist or when templates folder do not exist    To solve the problem   create a folder with name templates in the same directory where the python file is located and place the html file created in the templates folder

[python] Flask raises TemplateNotFound error even though template file exists

Examples related to python

Examples related to file

Examples related to templates

Examples related to flask