Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/garethjmsaunders/wp-rename-divi-projects/archive/refs/heads/main.zipUnlock the full potential of Divi Projects to make your site truly unique. Compatible with both Divi 4 and Divi 5.
About
Rename Divi Projects customizes Divi's built-in project custom post type so you can use it for content that better matches your site (for example: properties, books, albums, case studies).
You can rename labels and rewrite slugs while continuing to use Divi's project-related modules:
- Portfolio
- Filterable Portfolio
- Post Carousel (Divi 5) or Fullwidth Portfolio (Divi 4)
Customize the name
Change the default "Projects" post type labels and slugs to fit your content model without replacing Divi's underlying project system.
Features
- Rename labels Change singular/plural labels for the Project post type, Project Category taxonomy, and Project Tag taxonomy.
- Change slugs Customize rewrite slugs for project posts, project categories, and project tags.
- Choose a menu icon Select a Dashicon for the Projects menu item.
- Control admin menu visibility Set the minimum role level that can see the Projects menu in wp-admin.
- Divi single-project "Skills" label override Replaces Divi's front-end "Skills" label with your configured tag plural label.
Documentation
How to install
WordPress plugins are PHP scripts that extend WordPress functionality.
Rename Divi Projects is a standard WordPress plugin and can be installed like any other plugin.
Option 1: Upload via WordPress Admin (recommended)
- Download the
Rename Divi Projectsplugin zip file - Go to
Plugins > Add New Plugin - Select
Upload Plugin - Select the zip file
- Select
Install Now - Select
Activate Pluginafter installation completes
Option 2: Manual plugin installation via SFTP
- Download the
Rename Divi Projectsplugin zip file - Unzip it locally
- Upload the extracted plugin folder to
/wp-content/plugins/ - In WordPress, go to
Plugins - Find
Rename Divi Projectsand selectActivate
Getting started with Rename Divi Projects
After activation, go to Divi > Rename Divi Projects to open the plugin settings page to configure:
- Post type labels and slug
- Category labels and slug
- Tag labels and slug
- Menu icon
- Admin menu visibility minimum role
The plugin is designed for Divi's project ecosystem, so Divi project modules continue to work with your renamed labels and slugs (URLs).
Settings page
Location:
- Preferred:
Divi > Rename Divi Projects - Fallback (if Divi parent menu is not found):
Settings > Rename Divi Projects. Although, in truth, if Divi is not installed, the plugin installation will also fail gracefully.
Access:
- Users must have the
manage_optionscapability. - The settings page is added only in site admin (not in network admin).
TL;DR
- Update post type, category, and tag labels.
- Update slugs.
- Choose a menu icon.
- Set the minimum role for Projects menu visibility.
- Click Save Changes.
Page layout
The settings page is grouped into:
- Custom Post Type Settings
- Category Settings
- Tag Settings
- Admin Menu Visibility
Then a Save Changes button and a reset help section.
Custom Post Type Settings
Singular Name
- Default:
Project - Used in labels such as "Add New {Singular}" and edit screens.
Plural Name
- Default:
Projects - Used in menu and list labels such as "All {Plural}".
Slug
- Default:
project - Sanitized on save.
- Used as the project rewrite slug.
Menu Icon
- Default:
dashicons-portfolio - Choose from a curated Dashicons list (with search-enabled dropdown).
Category Settings
Category Singular Name
- Default:
Project Category
Category Plural Name
- Default:
Project Categories
Category Slug
- Default:
project_category - Sanitized on save.
- Used as the
project_categorytaxonomy rewrite slug.
Tag Settings
Tag Singular Name
- Default:
Project Tag
Tag Plural Name
- Default:
Project Tags - Also used for Divi's single-project front-end "Skills" label replacement.
Tag Slug
- Default:
project_tag - Sanitized on save.
- Used as the
project_tagtaxonomy rewrite slug.
Admin Menu Visibility
Set the minimum role level allowed to see the Projects admin menu item.
- Available levels:
Contributor,Author,Editor,Administrator - Default:
Contributor - Affects the
projectmenu page in wp-admin (edit.php?post_type=project) - The rule hides the menu item for users below the selected level
Important behavior:
- This is menu visibility control, not a full capability/access control system.
- It hides the menu item; it does not add explicit blocking for direct URL access.
- On multisite, super admins are not restricted by this setting.
- Custom roles outside the plugin's built-in role map are treated as level
0in this logic.
Save Changes
When you save:
- Settings are stored in the
divi_projects_cpt_rename_settingsoption. - Slug fields are sanitized.
- Rewrite rules are flushed automatically only when one or more slug values changed.
Depending on what changed values you save, you may still need to manually flush the Permalinks. To do this go to Settings > Permalinks and simply select the Save Changes button.
Reset to defaults
To return to Divi defaults in runtime behavior:
- Deactivate the plugin.
- Go to Settings > Permalinks and click Save Changes.
Your stored option values remain in the database until the plugin is uninstalled.
Deleting the plugin
When you uninstall/delete the plugin from WordPress, it removes the stored option in the WordPress database:
divi_projects_cpt_rename_settings
How it works
At a high level, the plugin re-registers Divi's existing project post type and its taxonomies with your configured labels/slugs.
Key mechanics:
- On
init, it registers:- post type key:
project - taxonomy keys:
project_category,project_tag - Settings values are pulled from one option:
divi_projects_cpt_rename_settings.
- post type key:
- On settings update, rewrite rules are flushed only if
slug,category_slug, ortag_slugchanged. - For UI placement, it adds the settings submenu under Divi when possible, otherwise under Settings.
- For admin menu visibility, it removes the
projectmenu page for users below the configured minimum role level. - For front-end single project pages, it replaces Divi's 'Skills' label with your configured tag plural:
- primary path:
gettextfilter for Divi domain strings - fallback path: output-buffer string replacement for hard-coded template output
- primary path:
Divi 4 vs Divi 5 note:
- The plugin does not hard-switch by explicit Divi version number.
- The two-step 'Skills' replacement (gettext + output-buffer fallback) exists to handle differences in how Divi templates may output that label across versions/templates.
Scope clarification:
- The plugin changes labels and rewrite slugs for Divi's existing Project custom post type (CPT) entities.
- It does not create a brand-new custom post type (CPT) key.
- Internal keys remain
project,project_category, andproject_tag.
Changelog
- v2.2.0 | 2026-02-14 | FIX | Update translations. Other minor updates and tweaks to follow conventions.
- v2.1.0 | 2026-02-14 | FEATURE | Add option to hide Projects (renamed or default) from certain user role levels.
- v2.0.0 | 2026-02-14 | FIX | Optimise plugin to work with both Divi 4 and Divi 5.
- v1.0.10 | 2024-10-03 | FIX | Ensure outputs go through escaping functions and sanitize input variable
$_POST.
Releases
1 release.
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.