ChapelOS · Your church, your website

Add a photo to a church page

← All help topics

Start here

  1. Open Photo library, choose an image, write its description and confirm permission.
  2. Upload, return to a page section and choose the photo.
  3. Save the draft, review the preview and publish when ready.

What to know

Open Website pages, then Photo library. Use Find a photo to search descriptions and choose Ready to use, Ready and unused, Used on website, Archived or Unfinished uploads. Search and filters work together. Counts beside each filter cover the whole library, before searching. Used means a current saved draft or published page; earlier versions and unsaved edits are not counted.

Clear search and filters to see everything again. Searching does not change or publish photos. Upload a JPEG or PNG up to 3 MB and 24 million pixels. Describe the image in plain words for visitors who cannot see it and confirm permission to publish. ChapelOS processes the image with Cloudflare Images and stores an optimized still WebP in private Cloudflare R2 storage.

Original files are not kept. Keep original photos separately. Each image fits within 1,600 pixels per side and 1 MB. After uploading, return to your page, open a section and choose its photo. Save, preview and publish. Uploading alone does not make an image public. Images are served publicly only while referenced by a published page or published homepage cover on a published church website.

Removing an image from one page does not hide it if another published page still uses it. Public visitors may keep copies they have already downloaded. The pilot allows 50 images per church including archived or unfinished uploads, and 100 processing attempts per calendar month. Archive unused images reversibly; first remove references from page drafts and publish changes wherever necessary.

Archiving does not free space. Earlier page versions with archived images require restoring those images before restoring the page. Contact support for permanent removal or incomplete uploads. Image files are included in the new website .tar backup archive. They remain excluded from older JSON content exports and generated installation packages.

Self-hosted operators must configure their own PHOTOS R2 bucket and IMAGES binding; uploads stay unavailable without both. Choose the Photo section kind for an image with an optional caption. Choose Edit description in the library to correct alternative text, including for archived photos. Saving updates the library only: open each affected page, save its draft to pick up the description, review all pending changes, then publish.

The Where this photo is used list links to current saved drafts and published pages, so you can see why a photo cannot yet be archived. It does not list older revisions or unsaved browser edits. If another owner changes the photo, your wording is retained for explicit review. There is no crop tool or bulk import yet.

Still unsure? Contact us.