Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A flexible, elegant and easy-to-use content management system. Textpattern is both free and open source.
PHP CSS JavaScript Other


Textpattern CMS 4.6-dev

Released under the GNU General Public License.
See LICENSE.txt for terms and conditions.

Includes contributions licensed under the GNU Lesser General Public License.
See LICENSE-LESSER.txt for terms and conditions.

Includes contributions licensed under the New BSD License.
See LICENSE-BSD-3.txt for terms and conditions.

== About ==

Textpattern CMS is a flexible, elegant and easy-to-use content management
system. Textpattern is both free and open source.

== Installation ==

* Extract the Textpattern files to your site (in the web root, or a
  subdirectory). The top-level index.php file should reside in this directory,
  as should the /textpattern/ and /rpc/ directories.
* Ensure the top-level .htaccess file is transferred to your site. The file is
  hidden by default on some operating systems, including OS X. Most FTP clients
  and IDEs have an option to show these hidden files. Otherwise, you can
  temporarily show hidden files in OS X by using the - follow these
* Create or verify the existence of a working MySQL database with valid username
  and password, then load /textpattern/setup/
  (or /subdirectory/textpattern/setup/) in your browser to start the
  installation process and follow the directions.
* When the installation is complete, remove the /textpattern/setup/ directory
  from your site.

== Upgrading ==

* Confirm your web server meets or exceeds the Textpattern system requirements:
* Log out of the Textpattern admin-side.
* Verify the existence of a known-good Textpattern database and file backup.
* Replace the top-level index.php, css.php and .htaccess files, everything in
  the /js/ directory, everything in the /rpc/ directory and everything in the
  /textpattern/ directory (except /textpattern/config.php) with the
  corresponding files in this distribution. Note: css.php and /rpc/ may not
  exist if the installed version of Textpattern is prior to 4.2.0.
* It is recommended that the browser cache is cleared to ensure the newer files
  are used in preference to the older files.
* Log in to the Textpattern admin-side. The upgrade script(s) will run
  automatically. Check the diagnostics (Admin -> Diagnostics) to confirm the
  correct Textpattern version number is displayed and whether there are any
  NOTE: Upgrades from versions prior to 4.2.0 will present warnings or errors
  upon the first login to the admin-side. These may include:
    Unknown column 'user_name' in 'where clause' select name,
    val from txp_prefs where prefs_id=1 AND user_name='' in
    /path/to/your/site/textpattern/lib/txplib_db.php on line xx
    Undefined variable: language in
    /path/to/your/site/textpattern/index.php at line xx
    Undefined variable: gmtoffset in
    /path/to/your/site/textpattern/update/_to_4.2.0.php at line xx
  This is expected behaviour. The messages will disappear with subsequent
  navigation in the admin-side.
* Verify all preference settings (Admin -> Preferences).
* Remove the /textpattern/setup/ directory from your site.

== Getting Started ==

* The Textpattern FAQ is available at
* In-depth documentation and a comprehensive tag index is available in the
  Textpattern documentation at
* You can get support and information via:
* If you are running an Apache web server, rename the .htaccess-dist file
  in the /files/ directory to .htaccess to prohibit direct URL access to
  your files. Thus the only route to these files becomes through the
  /file_download/ directory. It is recommended you consider employing this
  feature. Alternatively, move your /files/ directory out of a web-accessible
  location. Once moved, you can tell Textpattern of your new directory location
  from the Advanced Preferences.
* There are additional resources for the default front-side theme, such as
  Sass preprocessor files, available at:


* Check back regularly at to see if updates are
  available. Updates are as painless as possible, often fixing important bugs
  and/or security-related issues.
Something went wrong with that request. Please try again.