Title: Headless Portfolio CMS
Author: Al Adil Ashrafi Saikat
Published: <strong>Juny 9, 2026</strong>
Last modified: Juny 15, 2026

---

Search plugins

![](https://ps.w.org/headless-portfolio-cms/assets/icon-256x256.png?rev=3566610)

# Headless Portfolio CMS

 By [Al Adil Ashrafi Saikat](https://profiles.wordpress.org/aladilashrafi/)

[Download](https://downloads.wordpress.org/plugin/headless-portfolio-cms.1.1.1.zip)

 * [Details](https://bal.wordpress.org/plugins/headless-portfolio-cms/#description)
 * [Reviews](https://bal.wordpress.org/plugins/headless-portfolio-cms/#reviews)
 *  [Installation](https://bal.wordpress.org/plugins/headless-portfolio-cms/#installation)
 * [Development](https://bal.wordpress.org/plugins/headless-portfolio-cms/#developers)

 [Support](https://wordpress.org/support/plugin/headless-portfolio-cms/)

## Description

**Headless Portfolio CMS** transforms your WordPress installation into a powerful,
API-first backend specifically designed for developers, freelancers, agencies, and
creators. Build your dream portfolio using modern frontend frameworks (Next.js, 
React, Vue, Astro, Gatsby) while enjoying the familiar, user-friendly WordPress 
dashboard to manage your content.

Stop hardcoding your resume and project data! With Headless Portfolio CMS, you can
centrally manage your professional identity and expose it through clean, strictly-
typed REST API endpoints.

### 🚀 Core Features

 * **9 Dedicated Content Types:** Manage your **Projects**, **Experience**, **Education**,**
   Skills**, **Testimonials**, **Resumes**, **Services**, **Clients**, and an internal**
   Contact Inbox** out of the box.
 * **Custom Meta Fields:** Every content type comes with pre-configured, rich meta
   boxes (e.g., GitHub URLs, Live Demo links, Tech Stacks, Skill Levels, and Company
   details).
 * **Built-in CORS Management:** Easily configure Cross-Origin Resource Sharing (
   CORS) directly from the dashboard to allow your frontend applications to securely
   fetch data.
 * **Contact Form API:** Accept contact form submissions via a dedicated `POST /
   contact` endpoint with built-in rate limiting, inbox storage, and email notifications.
 * **On-Demand ISR Revalidation:** Automatically pings your Next.js frontend’s revalidation
   endpoint whenever content is published, keeping your static pages fresh without
   manual deploys.
 * **Global Profile & SEO Settings:** Manage your bio, social links, and default
   SEO metadata centrally.
 * **Dynamic Taxonomies:** Organize your projects by **Technologies**, **Categories**,
   and **Industries**. Group your skills by **Skill Categories**.
 * **API Reference Dashboard:** Includes a beautifully designed, built-in API reference
   guide right in your WordPress admin area to help you integrate quickly.
 * **Lightning Fast & Lightweight:** Zero bloat, no frontend assets loaded, and 
   highly optimized database queries for instant API responses.

### 💻 Built for Modern Frontends

Whether you are building a static site with Astro, a server-rendered app with Next.
js, or a single-page application with React or Vue, this plugin provides the perfect
data structure. The JSON responses are deeply nested and cleanly formatted, removing
the need for complex data parsing on your frontend.

### 🔒 Secure by Default

Read-only endpoints are publicly accessible. The contact form endpoint is rate-limited(
5 requests per IP per hour) and all submissions are sanitized. Your administrative
settings are fully protected by WordPress’s native nonces and capability checks.

## Screenshots

[⌊Portfolio CMS Dashboard overview.⌉⌊Portfolio CMS Dashboard overview.⌉[

Portfolio CMS Dashboard overview.

[⌊General Settings panel for profile and branding configuration.⌉⌊General Settings
panel for profile and branding configuration.⌉[

General Settings panel for profile and branding configuration.

[⌊Social Links Settings to add social profile links.⌉⌊Social Links Settings to add
social profile links.⌉[

Social Links Settings to add social profile links.

[⌊SEO Settings for meta title, meta description and og image.⌉⌊SEO Settings for 
meta title, meta description and og image.⌉[

SEO Settings for meta title, meta description and og image.

[⌊Configuration Panel For API and CORS settings.⌉⌊Configuration Panel For API and
CORS settings.⌉[

Configuration Panel For API and CORS settings.

[⌊Built-in API Reference documentation dashboard.⌉⌊Built-in API Reference documentation
dashboard.⌉[

Built-in API Reference documentation dashboard.

[⌊Project Management interface with custom portfolio fields.⌉⌊Project Management
interface with custom portfolio fields.⌉[

Project Management interface with custom portfolio fields.

[⌊Skills Management with custom categories and proficiency levels.⌉⌊Skills Management
with custom categories and proficiency levels.⌉[

Skills Management with custom categories and proficiency levels.

[⌊Experience content editor with company details and metadata.⌉⌊Experience content
editor with company details and metadata.⌉[

Experience content editor with company details and metadata.

[⌊Service content editor with service details and metadata.⌉⌊Service content editor
with service details and metadata.⌉[

Service content editor with service details and metadata.

[⌊Testimonial content editor with testimonial details and metadata.⌉⌊Testimonial
content editor with testimonial details and metadata.⌉[

Testimonial content editor with testimonial details and metadata.

[⌊Resume Management with resume file url and metadata.⌉⌊Resume Management with resume
file url and metadata.⌉[

Resume Management with resume file url and metadata.

[⌊Education History Management with certificate url and metadata.⌉⌊Education History
Management with certificate url and metadata.⌉[

Education History Management with certificate url and metadata.

## Installation

 1. Download the `headless-portfolio-cms.zip` file.
 2. Go to **Plugins > Add New** in your WordPress admin dashboard.
 3. Click **Upload Plugin** and select the downloaded zip file.
 4. Click **Install Now** and then **Activate**.
 5. Navigate to the **Portfolio CMS** menu item in your sidebar to configure your profile
    and start adding content!

## FAQ

### Do I need a specific WordPress theme to use this?

No! This is a headless CMS plugin, making it completely theme-agnostic. Your WordPress
installation merely acts as the database and API provider.

### How do I connect my frontend application?

Simply go to **Portfolio CMS > Settings > API & CORS**, add your frontend’s URL 
to the Allowed Origins list, and start making `GET` requests to the endpoints shown
in the Dashboard or API Reference.

### Are the API endpoints cached?

The plugin provides a configuration setting for API Cache Duration, which you can
use in conjunction with your frontend caching strategies (like Next.js ISR).

### How does on-demand revalidation work?

Go to **Portfolio CMS > Settings**, enter your frontend’s URL and a revalidation
secret token. Whenever you publish or update content, the plugin will automatically
call your frontend’s `/api/revalidate` endpoint to purge the relevant cached pages.

### How does the contact form work?

Send a `POST` request to `wp-json/hpcms/v1/contact` with a JSON body containing `
name`, `email`, `subject`, `message`, and optionally `budget`. Submissions are saved
to the Contact Inbox in the dashboard and forwarded to your configured notification
email. The endpoint is rate-limited to 5 requests per IP per hour.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Headless Portfolio CMS” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Al Adil Ashrafi Saikat ](https://profiles.wordpress.org/aladilashrafi/)

[Translate “Headless Portfolio CMS” into your language.](https://translate.wordpress.org/projects/wp-plugins/headless-portfolio-cms)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/headless-portfolio-cms/),
check out the [SVN repository](https://plugins.svn.wordpress.org/headless-portfolio-cms/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/headless-portfolio-cms/)
by [RSS](https://plugins.trac.wordpress.org/log/headless-portfolio-cms/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.1

 * Fixed a critical bug that reported missing settings pages.

#### 1.1.0

 * Improved settings architecture and automatic data migration.
 * Renamed Profile Info tab to General.
 * Added favicon, header button, and footer text settings.
 * Added support for multiple locations.
 * Expanded social profile options.
 * Renamed API & CORS tab to Configuration.
 * Added new REST API endpoint: /wp-json/hpcms/v1/main
 * Deprecated the /profile endpoint

#### 1.0.0

 * Initial public release!
 * Implemented modular PSR-4 architecture.
 * Added core content entities (Projects, Experience, Skills, etc.) with custom 
   meta fields.
 * Integrated CORS and API security management.
 * Built-in API Reference Dashboard.
 * Optimized admin menu placement for better UX.

## Meta

 *  Version **1.1.1**
 *  Last updated **1 dia ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.1 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/headless-portfolio-cms/)
 * Tags
 * [cms](https://bal.wordpress.org/plugins/tags/cms/)[headless](https://bal.wordpress.org/plugins/tags/headless/)
   [nextjs](https://bal.wordpress.org/plugins/tags/nextjs/)[portfolio](https://bal.wordpress.org/plugins/tags/portfolio/)
   [rest-api](https://bal.wordpress.org/plugins/tags/rest-api/)
 *  [Advanced View](https://bal.wordpress.org/plugins/headless-portfolio-cms/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/headless-portfolio-cms/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/headless-portfolio-cms/reviews/)

## Contributors

 *   [ Al Adil Ashrafi Saikat ](https://profiles.wordpress.org/aladilashrafi/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/headless-portfolio-cms/)