# About the Project Items API

The Project Items API allows you to manage a project's items. Learn more about [project items in Wix Portfolio](fallback::https://support.wix.com/en/article/wix-portfolio-adding-media-to-projects).


With the Project Items API, you can:

+ [Create](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/create-project-item), [update](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/update-project-item), and [delete](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/delete-project-item) project items. 
+ [Retrieve](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/get-project-item) or [list](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/list-project-items) project items. 
+ [Duplicate](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/duplicate-project-items) project items from one project to another project.
+ Listen for events when a project item is [created](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-created), [updated](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-updated), or [deleted](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-deleted). 

## Before you begin

It's important to note the following points before starting to code:

+ You need an existing project to create project items. If you don't already have one, call [Create Project](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/projects/create-project) to create a project, and then call [Create Project Item](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/create-project-item) to create a project item. 
+ Project items consist of images or videos. Before you create or update a project item with a new media file, upload the media file to the [Wix Media Manager](fallback::https://support.wix.com/en/article/wix-media-about-the-media-manager) by calling the [Import File](fallback::https://dev.wix.com/docs/sdk/backend-modules/media/files/import-file) method.
+ You can only use this API on sites where a Wix user has installed the [Wix Portfolio app](fallback::https://www.wix.com/app-market/web-solution/wix-portfolio?appIndex=0&collimp_id=b54d3569-fdaa-49f6-83f8-2ac6e400bd11&referralSectionName=wix%20portfolio).

## Use case

+ [Create a digital photo frame](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/sample-flows).

@package_metadata:@wix/portfolio

To use the ProjectItems API, install the `@wix/portfolio` package.

#### Install the package

Follow the installation instructions for your development environment.

| Development environment | Installation method |
|--|--|
| Wix sites (editor or IDE) | Use the [package manager](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor). |
| Wix sites (local IDE) | Run `wix install @wix/portfolio` using the [Wix CLI](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-with-the-wix-cli).|
| Blocks apps | Use the same installation method as Wix sites. |
| CLI and self-hosted apps | Run `npm install @wix/portfolio` or `yarn add @wix/portfolio`. |
| Headless sites and apps | Run `npm install @wix/portfolio` or `yarn add @wix/portfolio`. |

#### Import the package

To import the package in your code:

```js
import { projectItems } from '@wix/portfolio'
```

# Sample Use Case and Flow



This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.



## Create a digital photo frame
You can display a live photo gallery on a digital photo frame, updating dynamically in real-time.

1. Call [Create Project](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/projects/create-project) to create a project that will act as the photo gallery, allowing you to store and manage photos represented as project items within the gallery.

2. Share the newly created project's ID with those who need to access the gallery so they can add or remove photos from the digital photo frame.

3. Listen for [Project Item Created](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-created), [Project Item Updated](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-updated), and [Project Item Deleted](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/on-project-item-deleted) events to detect when new photos are added, existing photos are updated, or photos are removed from the gallery.

4. Periodically call [List Project Items](fallback::https://dev.wix.com/docs/sdk/backend-modules/portfolio/project-items/list-project-items) to retrieve the latest gallery content and ensure the photo frame reflects real-time changes.

onProjectItemCreated( )