GET IN TOUCH ››

Frequently Asked Questions

Contents

 

ProcessWire Admin User Guide

 

A comprehensive operational manual for editors, site managers, and administrators.

1. Navigating the Admin & Finding Content

How do I log in to the ProcessWire Admin?

  1. Open your browser and navigate to yourdomain.com/processwire/ (or your custom admin URL).
  2. Enter your Username and Password.
  3. Click Log In.
Security Note: If Two-Factor Authentication (2FA) is enabled on your account, you will be prompted to enter your verification code after entering your credentials.

How do I navigate the Page Tree?

The Page Tree is the central site hierarchy found under the Pages menu item.

  • Click any folder/parent page name to expand its child pages.
  • Hover over any page title to reveal context action links:
    • Edit: Opens the content editor screen.
    • View: Opens the live page on the website in a new browser tab.
    • New: Creates a new child page under this item.
    • Move: Reorders or updates the page's parent location.

How do I search for a page if I can't find it in the tree?

Use the global Search Bar in the top admin header. You can search by page title, URL slug, or keywords. For detailed queries, use Pages > Search in the top navigation to filter by template, publication date, or status.

2. Managing Pages (Adding, Editing, Moving)

How do I add a new page?

  1. Go to Pages in the top bar.
  2. Locate the parent section (e.g., hover over "About Us" to add a new "Team Member").
  3. Click + New next to the parent page.
  4. Select the correct Template for the content type.
  5. Type the page Title. ProcessWire generates the clean URL slug automatically.
  6. Click Save (draft) or Save + Publish (live).

How do I edit an existing page?

Locate the page via the Tree or Search bar, click Edit, update the fields across the edit tabs (Content, SEO, Settings), and click Save.

How do I reorder or move pages in the Page Tree?

  • Reorder Siblings: Click and drag the handle icon next to any page up or down within the Page Tree.
  • Move Parent: Edit the page, open the Settings tab, update the Parent Page field, and save.

What is the difference between "Save", "Save + Keep Editing", and "Unpublish"?

  • Save / Save + Publish: Applies changes immediately to the live website.
  • Save + Keep Editing: Saves your work without redirecting you back to the tree view.
  • Unpublish: Hides the page from site visitors while preserving all content for future editing.

3. Working with Content & Rich Text Editors

How do I format text using the Rich Text Editor?

  • Headings: Highlight text and choose Heading 2 or Heading 3 from the Format menu. Avoid Heading 1 (H1), as page titles handle H1 tags automatically.
  • Bold / Italic: Highlight text and click B or I on the toolbar.
  • Lists: Use the bulleted or numbered list buttons to group related items.

How do I insert links?

  1. Highlight the link text and click the Link (chain-link) icon.
  2. Internal Pages: Click Select Page, navigate the interactive tree picker, and choose the target page.
  3. External Pages: Type or paste the full URL (including https://).

How do I upload and insert images into body copy?

  1. Place your cursor where the image should go and click the Image toolbar icon.
  2. Drag and drop your file into the window or select it from your device.
  3. Configure alignment (Left, Right, Center) and set mandatory Alt Text for accessibility.
  4. Click Insert.

4. News Articles, Blogs & Time-Sensitive Content

How do I publish a new News Article or Blog Post?

  1. Locate your main News or Blog container in the Page Tree.
  2. Click + New next to the container.
  3. Fill out the core fields: Headline Title, Publication Date, Summary/Teaser, Body Copy, and Featured Thumbnail Image.
  4. Click Save + Publish.

How do I schedule an article for future publication?

If your template supports date filtering, set the Publish Date field to a future date and time and save the page. Front-end queries automatically hold back the post until that date arrives.

5. SEO & Social Media Metadata

Where do I find SEO fields when editing a page?

Look for the dedicated SEO or Meta tab located along the top editor navigation when viewing any page.

How do I optimize Meta Titles and Descriptions?

  • Meta Title: Enter a concise title (50–60 characters). If left blank, ProcessWire falls back to the main Page Title.
  • Meta Description: Write a 150–160 character overview snippet to display in Google search results.

What is a Canonical URL field, and when should I set it?

Canonical tags prevent duplicate content penalties across search engines. Leave this blank by default. Fill in a full URL (e.g., https://originalsite.com/post/) only if you are syndicating or republishing content originally posted on another site.

How do I control social media share cards (OpenGraph)?

  • OpenGraph Image: Upload a 1200 x 630 pixel image for social media cards on Facebook, LinkedIn, X, and Slack.
  • OpenGraph Title & Description: Optional override fields. If left blank, social platforms use your primary Meta values.

How do I hide a page from Google search indexes?

Open the page's SEO or Settings tab, check the Robots / Prevent Search Indexing box (or select noindex, nofollow), and save.

6. Deleting, Trashing, and Unpublishing Pages

How do I move a page to the Trash?

Open the page in Edit mode, click the Delete tab (or red Trash button in the footer), and confirm by clicking Trash Page.

How do I restore a page from the Trash?

Expand the system Trash folder at the bottom of the Page Tree, edit the page, and select Restore Page under the Settings tab.

How do I permanently delete a page?

Edit the page inside the Trash container, open the Delete tab, check Delete Permanently, and confirm. This action cannot be undone.

7. Media Management (Images & Files)

How do upload fields work?

  • Upload: Drag files directly into dashed upload containers or click Choose File.
  • Crop / Focus Point: Hover over an image thumbnail and click Focus Point to set smart-cropping boundaries for mobile devices.
  • Captions & Alt Text: Complete the text fields attached directly to each uploaded thumbnail.

8. User Accounts, Passwords & Access Control

How do I change my admin password?

Click your Profile Name in the top-right header, enter a new password in the password field, confirm it, and click Save.

Why can't I edit a specific page or see menu options?

ProcessWire uses role-based permissions (e.g., Admin, Editor, Author). If options are missing, contact your system administrator to update your user account permissions.

9. Troubleshooting & Best Practices

Issue Likely Cause Recommended Action
Changes not appearing on live page Server caching active Click Clear Cache in the admin top bar or hard-refresh your browser (Ctrl+F5 / Cmd+Shift+R).
Page URL changed automatically URL Sanitization ProcessWire automatically converts spaces and symbols into lowercase hyphenated strings.
Cannot delete a parent page Child pages exist ProcessWire blocks deletion of parent folders until all child pages are moved or trashed.
File upload fails Exceeds size limit Compress images prior to upload or ask your web administrator to increase server upload limits.

 

Our Partners

Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo Partner Logo