Welcome to ProcessWire 3.x
This document is in Markdown. An HTML formatted version of this document
can be read at: https://github.com/processwire/processwire/blob/master/README.md, (*1)
Table of Contents
- About
- Installation
- Upgrading
- Troubleshooting
- Support
About ProcessWire
ProcessWire is a friendly and powerful open source CMS with an API that is a
joy to use at any scale. It is both a content management system (CMS) and
framework (CMF) built to save you time and work the way you do. With all custom
fields, a secure foundation, proven scalability and performance, ProcessWire
connects all of your content seamlessly, making your job fast, easy and fun., (*2)
ProcessWire gives you more control over your fields, templates and markup than
other platforms, while ProcessWireâs API makes working with your content easy and
enjoyable. Managing and developing a site in ProcessWire is shockingly simple
compared to what you may be used to., (*3)
ProcessWire is widely trusted by web professionals for its exceptional consistency,
stability and security; revered by web developers for its API that saves time and
makes work fun; valued by web designers for its adaptability and flexibility with
modern website/application content management needs; and loved by clients for its
no-nonsense interface and ease-of-use in adding, updating and maintaining content.
New versions of ProcessWire are released just about every week on the
development branch., (*4)
Background
ProcessWire is a timeless tool for web professionals that has always been
committed to the long term. It started in 2003, gained the name ProcessWire
in 2006, and has been in active development as an open source project since 2010.
Now more than a decade later (2025), weâre just getting started, as ProcessWire
continues to grow and develop into the next 10 years and beyond., (*5)
While ProcessWire has been around for a long time, donât feel bad if you havenât
heard of it till today. We are fundamentally different from other projects in
that we donât make a lot of noise, weâre not into promotion, we value quality
over quantity, sustainability over growth, and a friendly community over
popularity. ProcessWire is designed to be a silent partner, not easily
identified from the front-end of any website. We donât aim to be big, we are
instead focused on being best-in-class., (*6)
Web developers find ProcessWire when the time is right, after theyâve tried
some other platforms. And once they start using ProcessWire, they tend to
stay. ProcessWire is addictive, easy to maintain for the long term, and doesnât
have the security and upgrade woes of other platforms. But donât take our word
for it; unless your livelihood depends on some other platform, find out for
yourself., (*7)
ProcessWire is more than just software, it is also a friendly community
of web professionals dedicated to building great sites and applications, and
helping others do so too., (*8)
Please visit and join our
friendly community
in the ProcessWire forums, subscribe to our
weekly newsletter
for the latest ProcessWire news, check out our
website showcase
to see what others are building with ProcessWire., (*9)
Weekly ProcessWire news is posted by Teppo Koivula on his site
ProcessWire Weekly.
Weekly core updates and related topics are posted by Ryan Cramer in the
ProcessWire support forum
News and Announcements
board., (*10)
Learn more
Installing ProcessWire
Simply extract the ProcessWire files to an http accessible location and
load the URL in your web browser. This will start the installer. See our
Installation Guide for more
details and instructions. If you run into any trouble, please see our
Troubleshooting Guide., (*11)
Upgrading ProcessWire
Upgrading is easy and usually just a matter of replacing your /wire/
directory
with the one from the new version. But to be safe, before proceeding with any version upgrade, please see the
Upgrading ProcessWire
guide and perhaps keep it open during your upgrade in case you need to refer back to it., (*12)
When upgrading from one 3.x version to another, please use the
general upgrade process.
This consists primarily of making sure you've got everything backed up and then just
replacing your /wire/
directory with the one from the newer version., (*13)
Pro module version upgrade notes (if applicable)
-
FormBuilder
version 0.5.5 or newer recommended.
-
ListerPro
version 1.1.6 or newer recommended.
-
ProFields
the latest versions of all ProFields (10 modules) are recommended.
-
LoginRegisterPro
version 8 or newer recommended.
-
ProCache
version 4.0.5 or newer recommended. After upgrading, go to your ProCache
settings in the admin (Setup > ProCache) and see if it suggests any
modifications to your .htaccess file., (*17)
-
For all other Pro modules not mentioned above we recommend using the
latest available versions when possible., (*18)
Debug Mode
Debug mode causes all errors to be reported to the screen. This can be
helpful during development or troubleshooting. When in the admin, it also
enables a âDebugâ link (see footer) for reporting of extra information in a
panel. Debug mode is not intended for live or production sites, as the
information reported is for the developer only. Do not leave debug mode
on for any live/production sites, as it could be a security concern. However,
we think you'll find it very handy during development or when resolving issues., (*19)
- Edit this file:
/site/config.php
- Find this line:
$config->debug = false;
- Change the
false
to true
like below, and save.
$config->debug = true;
This can be found near the bottom of the file, or you can add it if not
already there. It will make PHP and ProcessWire report all errors, warnings,
notices, etc. Of course, you'll want to set it back to false once you've
resolved any issues., (*20)
Support and Links
Copyright 2025 by Ryan Cramer / Ryan Cramer Design, LLC, (*21)