> Part of [WHCC Developer Documentation](https://www.whcc.com/developer/llms.txt)

# Albums

## Getting Started

Album products require some additional properties to be specified on the [Order Request](https://www.whcc.com/developer/docs/order-submit-api/order-submit/index.html.md). This document outlines those necessary additions to help you construct an appropriate album order.

**NOTE: Every album requires Item Attributes "Individual Page JPG" (539) and "Album 2 Page Spread" (1029) to be specified.**

Album orders are limited to a single OrderItem

### Assets

Album assets for the spreads as well as any cover photos need to be JPEGs

### Page Numbers

Each ItemAsset must have a page number defined on it, starting from 1. Cover assets will all have a page number of 0 or be excluded altogether.

```json
"ItemAssets": [
  {
    "AssetPath": "ASSET_URL",
    "ImageHash": "HASH",
    "DP2NodeID": 10000,
    "ImageRotation": 0,
    "PageNumber": 1
  },
  ...
]
```

### Book Attributes

An ItemBookAttribute object must be defined, as a sibling to ItemAttributes specifiying how many pages will be in the album as well as any BookAttributeUID which will relate to album specific attributes, such as paper type. These BookAttributeUID are available in the [product catalog](https://www.whcc.com/developer/docs/order-submit-api/request-catalog/index.html.md).

```json
"ItemAttributes": [...],
"ItemBookAttribute": {
    "BookAttributeUID": 136,
    "NumberOfPages": 5
}
```

## Covers

There are several available album covers to choose from. There are a few minor additions required to properly specify an album cover.

### IsCoverAsset

ImageAssets which are expected to be part of the cover need to have the IsCoverAsset: true flag set on them. Additionally, their PageNumber should be 0 or excluded entirely.

```json
{
    "AssetPath": "ASSET_URL",
    "ImageHash": "HASH",
    "DP2NodeID": 10000,
    "IsCoverAsset": true,
    "PageNumber": 0
}
```

### Material Covers

Material covers do not contain an asset to print, so an ItemAsset is not allowed when ordering.

**Debossing is only available on Material Covers.**

### Cameo Covers

Cameo covers currently require a single IsCoverAsset ItemAsset with ProductNodeId: 10001

A Cameo cover album also requires the 2309 Item Attribute.

### Photo Covers

Coming soon!

### Combo Covers

Combo covers come in two varieties: