How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial

Update: We’ve created a second edition of this popular tutorial! It contains updated code samples, coverage of the latest theme development techniques, and more. Check it out at The ThemeShaper WordPress Theme Tutorial: 2nd Edition.

In only 11 individual lessons this WordPress Theme Tutorial is going to show you how to build a powerful, up-to-date, WordPress Theme from scratch. As we go along I’ll explain what’s happening including (for better or worse) my thinking on certain techniques and why I’m choosing one path over another. Essentially, I’ll be teaching you everything you need to know about WordPress Theme development.

Skip to the Table of Contents.

tutorial-graphic-large

Here’s the list of features your finished theme will be able to boast of:

  • All the search-engine optimization you’ll really need
  • Including google-supported Microformat markup
  • Valid and logical semantic markup structure than can be used to create ANY layout
  • Smart default CSS layouts
  • Dynamic Body, post and comment classes
  • Separated trackbacks and threaded comments
  • 2 widget areas coded to disappear when they’re empty
  • And all the typical WordPress stuff you expect from a theme

I think that’s kind of impressive—for any WordPress Theme.

At the end of this tutorial, with code in hand, you’ll be able to do almost anything you want. You can even think of the finished Theme as your own personal website development framework for WordPress.

I’ve already used it to start another project of my own, The Shape Theme. Download it and check it out if you’d like to see some of the finished code we’ll be going through, live, in action. Alternately, you can browse through the up-to-date source code for the entire tutorial on Google Code.

WordPress Theme Tutorial Table of Contents

Ready for a WordPress Theme Tutorial that will show you how to create a powerful WordPress Theme from scratch? Read it from the beginning and code yourself up something awesome.

  1. WordPress Theme Tutorial Introduction
  2. Theme Development Tools
  3. Creating a Theme HTML Structure
  4. Template and Directory Structure
  5. The Header Template
  6. The Index Template
  7. The Single Post, Post Attachment, & 404 Templates
  8. The Comments Template
  9. The Search Template & The Page Template
  10. The Archive, Author, Category & Tags Template
  11. The Sidebar Template
  12. Reset-Rebuild Theme CSS & Define Your Layouts

318 responses

  1. […] been following Themeshaper’s How to Build a WordPress Theme series for last couple weeks. Overall, it’s been ok, but a little too code-heavy, and not […]

  2. Thanks. Gonna start next week.

  3. Wow! you da man!

    thanks so much from this fledgling WP enthusiast!!

  4. […] of ThemeShaper, the man behind the Thematic WordPress Theme framework, has recently published a comprehensive tutorial on creating your own unique WordPress […]

  5. This is definitely going to be the ultimate tutorial I have ever come across! Cant Wait 🙂

  6. Fantastic serie !!!
    I’m a beginner in blogging with wordpress and started a serie of posts about how I’m learning it.
    Your tutorial is exactly what I was looking for and I think it could be very helpfull to have a translation of it in french.
    If you agree with it I could do it for my blog with, of course, link to your posts, blog and promotion of Thematic.
    Let me know if you’re intersted with this idea.
    Thanks.

  7. […] How To Create a WordPress Theme (tags: useful tutorials wordpress webdevelopment) […]

  8. […] How To Create a WordPress Theme (tags: wordpress tutorial theme howto webdesign themes tutorials design) […]

  9. Hi Ian,

    This series is what I need to get Archetype out of the beta stage. I believe my theme is going to be better after reading this. Thank you so much for sharing your knowledge.

  10. This tuts are step by step just the way we like it!
    great work!

  11. […] The icons are free to use – no strings attached. […]

  12. Lucas Tadeu Avatar
    Lucas Tadeu

    Just what I was looking for, thanks (:

  13. Great great. Thanks so much Ian !

  14. […] than 2 years ago, Ian Stewart from ThemeShaper.com felt the need to create a new series teaching how to create a WordPress theme. So, if you always wanted to create your own WordPress theme and didn’t know how to, go check […]

  15. […] How To Create a WordPress Theme […]

  16. […] How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial […]

  17. Nice post. Thanks!

  18. […] Create a WordPress Theme: The Ultimate Tutorial […]

  19. […] de son site une série de 12 articles formant un tutoriel sur la création de thème WordPress : How To Create a WordPress Theme. J’ai littéralement dévoré ces leçons à la fois concises et complètes et totalement […]

  20. […] Par Eiffair | Publié : 13 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  21. […] Par Eiffair | Publié : 13 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  22. […] to the white, maroon and grey that you’re more accustomed to. Well, after following the How To Create A WordPress Theme tutorial on the Themeshaper blog, I’ve delved into the realm of creating my own theme. It’s […]

  23. […] du Thème Par Eiffair | Publié : 13 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Them rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  24. […] How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial: Har ni någonsin funderat på att skapa ert eget WordPress tema? I så fall finns det en guide för er som är intresserade av att knåpa ihop ett tema från början till slut! I elva steg visar Ian Stewart hur ni ska gå tillväga. Kanske är det något man skulle prova på, eller? Nja, jag tror inte jag själv skulle få ihop ett kvalitativt tema, men ni kanske kan? […]

  25. […]   开始学习精博翻译的Ian Stewart的WP主题制作教程如何创建 WordPress 主题,英文原版点此。 […]

  26. Thank You sooo much!!!

    That´s what i was looking for for a very long time!!!!
    finally i found it! Thanx again!

  27. […] Templates Par Eiffair | Publié : 14 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Them rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  28. […] Header Par Eiffair | Publié : 14 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Them rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  29. […] Index Par Eiffair | Publié : 14 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  30. […] et 404 Par Eiffair | Publié : 16 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  31. […] Comments Par Eiffair | Publié : 16 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  32. […] original post here: How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial Share and […]

  33. […] How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial […]

  34. […] et Page Par Eiffair | Publié : 21 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  35. […] How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial […]

  36. […] this site is to be viewed as an on-going project. Beginning with a tutorial at ThemeShaper.com on creating your own WordPress theme and then building off of previous knowledge from older yet similar tutorials as well as my custom […]

  37. […] original here: How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial Share this on del.icio.usDigg this!Buzz up!Stumble upon something good? Share it on […]

  38. I have a strange thing happening. I can’t get the sidebars to show up at all. I’ve copied and recopied the exact files from the google code area, but still no avail. The sidebars just won’t show up. Any ideas? I’ve got them on a test area here: http://www.bcjonesonline.com/test1

    Thanks.

    1. Ian Stewart Avatar
      Ian Stewart

      I’d try resetting your widgets by uncommenting the 1 line in the tutorial code (it’s noted there).

  39. […] How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial […]

  40. […] code is based on Ian Stewart’s “How To Create a WordPress Theme: The Ultimate WordPress Theme Tutorial“, which I highly […]

  41. […] Sidebar Par Eiffair | Publié : 29 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  42. […] CSS Par Eiffair | Publié : 29 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  43. […] et Tag Par Eiffair | Publié : 21 juillet 2009 Cet article est une traduction du tutoriel How To Create a WordPress Theme rédigé par Ian Stewart, l’auteur du framework WordPress Thematic disponible sur son site […]

  44. Thanks for the excellent article. It had clear my doubt, i m using it from past 2 months but getting the good result.