Plumbit Projects are reusable WordPress records managed by the Plumbit Extensions plugin. A published Project can be displayed by the Projects Elementor widget or opened on its individual Project URL.
Before you begin#
- Confirm Plumbit and Plumbit Extensions are active.
- Use an account with permission to manage Projects and their media.
- Prepare the Project title, description, featured image, and Project Category terms before you start.
- Use a backup or staging site before making substantial content changes.
If the Projects menu is missing, check the extension plugin and your user permissions before troubleshooting the record itself.
Open the Projects screen#
In WordPress, open Projects > All Projects. Select Add New Project to create a record, or choose an existing Project title to edit it. The Projects area also includes Project Categories.
Add a Project#
Enter the title and description#
Add the Project title and write the main description in the WordPress editor. The single Project template renders this saved content inside its Project content area.
Set the featured image#
Choose a featured image when the Project widget or card design uses record media. The Project widget reads the record's featured image for post-type content.
Assign a Project Category#
Use the Project Categories taxonomy when the widget query or frontend category filter needs to group the record. A Project can have more than one category.
Review layout options#
Review the shared Page Layout, Page Options, and Page Sections panels. These can control the sidebar, page header, and header or footer provider for this Project when a page-level override is available.
Preview and publish#
Preview the Project, check its public URL, then select Publish. For an existing record, select Update after editing.
Understand the Project fields#
| Field | Where it appears | Required? | Notes |
|---|---|---|---|
| Title | Project page and widget cards | WordPress content field | Used as the record title unless a Content List item supplies different text. |
| Main content | Single Project content area | Optional content | Edited in the main WordPress editor and can be edited with Elementor where the editor is available. |
| Excerpt | WordPress record and any template or widget that requests it | Optional | Plumbit's Projects widget does not use a separate Project Description field. |
| Featured image | Project widgets and card designs | Optional | Post-type widget output omits image-dependent cards when no image is available. |
| Project Categories | Widget filters and category archive URLs | Optional | Assign terms only when the widget or archive workflow needs them. |
| Page Layout and Page Options | Single Project page | Optional | Shared layout, sidebar, page-header, and page-section overrides are separate from Project content. |
The Project editor does not provide active Project-specific Client, Location, Date, Website, Gallery, or Project metadata fields. Do not expect those fields to appear unless another installed extension adds them.
Project title and permalink#
The post type uses the project slug by default, while the theme can provide a Projects Parent Slug and Project Slug setting. Changing a published title does not always change its existing permalink automatically. Treat an established Project URL as a public link and plan a redirect before changing a slug.
Project description#
The single Project template outputs the saved main editor content. Post Type widget cards use the Project title and featured image, while Content List items can use text saved directly in Elementor. If the visible text is not the record description, inspect the widget's content mode before editing the Project.
Featured images and categories#
Use the featured image for Post Type Project cards. Plumbit does not provide a Project gallery field. A category term can be assigned from the Project editor or managed from Projects > Project Categories; category archive links use the configured Projects parent slug.
Review page-level settings#
Projects use the shared Page Layout, Page Options, and Page Sections panels. These include sidebar selection, Page Header settings, Footer Widget Area, Footer Copyright Area, and provider/template overrides. When a page-level control supports inheritance, leaving it unset allows the corresponding global setting to apply. Where a matching page-level override is available, use it for a deliberate exception.
Preview, publish, and update#
Use Save Draft while preparing a Project, Preview to inspect an unpublished record, Publish to make a new record public, and Update after changing an existing record. Refresh a page or widget after saving so you are checking the current source record.
Trash and restore#
Move an unwanted Project to Trash from the Projects list. Trashing a Project removes it from Post Type queries and makes its public Project URL unavailable. Content List and Single Project widget items are stored separately in Elementor and are not removed when a Project record is trashed. Restore the record from the Trash view when needed, or permanently delete it only when the record and its public links are no longer required.
Expected result#
The Project is published at its single Project URL and is available to Post Type queries and Project Category filters. Content List and Single Project modes use content stored directly in Elementor rather than selecting this Project record.
Common problems#
Support escalation#
Send the Project title and URL, the page or widget where it should appear, Project status, taxonomy terms, widget name, Plumbit version, Plumbit Extensions version, Elementor version, WordPress version, PHP version, and a screenshot. Do not send passwords.
For a persistent critical error, contact Plumbit support.
Related articles
How Plumbit project widgets display content
Understand Post Type queries, direct Content List items, category filters, ordering, links, and field ownership.
Troubleshooting Plumbit projects
Diagnose missing Projects, wrong images, empty filters, incorrect links, ordering, 404s, stale output, and missing widgets.
How Plumbit content is organized and where to edit it
Identify whether a visible section comes from Elementor, a reusable WordPress record, a global theme setting, or a page-level override.