Perch CDN integration


Perch is a flexible content management system preferred by web design agencies and small teams. It is a page based CMS that features an architecture based on mapping content to pages. Perch is often chosen because:

  • It combines structured content with complete design flexibility.
  • It features powerful tag-based template system.
  • It’s really easy to manage.

Perch isn't a slow CMS, but if you want to make it faster, you can integrate it with CDN. Here are the detailed instructions on how to integrate Perch with CDN correctly.

Before you start

  • Before you take any steps please back up your files and database.
  • In the following, we will integrate a CDN service using the CDN domain Please visit the Services/How-To section to obtain your CDN domain.
  • To integate a CDN service on https:// website you can use or you can use a custom CDN domain with SSL enabled.
  • If your website embeds custom fonts then please first enable CORS for them.
  • Before you take any steps please make sure that your CDN domain is ready-to-use here.

Create CDN Static service

Please refer to Creating a CDN Static service for more details.

Enable CDN in Perch

  1. In the Perch document root in the file config/config.php replace the following:
    define('PERCH_RESPATH', PERCH_LOGINPATH . '/resources');
    with the following:
    define('PERCH_RESPATH', '' . PERCH_LOGINPATH . '/resources');    
  2. Optionally if you have a custom bucket list then in the Perch document root in the file config/buckets.php replace the following:
    'web_path'  => '/my/bucket/path',
    with the following:
    'web_path'  => '',
  3. That's all.


  • View HTML source code of your web pages to verify that you are using CDN, you should see source attribute of your images, CSS, JavaScript, etc. beginning with your CDN domain.
  • Don't see your CDN domain in source code of your web pages? If your website is using any cache plug-in/mechanism then you might want to clear/flush its cache.
  • Having troubles with custom fonts? Please refer to Using custom fonts with CDN - setting CORS for more details.
  • Still having troubles? Check your CDN URLs in our CDN content check or please refer to Debugging a CDN service for more hints.

Contact Us

  _____     ______    ____    
 /  ___||  /_   _//  |  _ \\  
| // __     -| ||-   | |_| || 
| \\_\ ||   _| ||_   | .  //  
 \____//   /_____//  |_|\_\\  
  `---`    `-----`   `-` --`