Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shootbin.com/llms.txt

Use this file to discover all available pages before exploring further.

Approvals give you and your client a clear record of which photos make the cut. Approvers (clients) can approve or reject photos one at a time or in bulk, and photographers can see every decision at a glance. On Pro and Agency plans, selection packages let you define exactly how many photos a client can pick from each album — perfect for packages that include a set number of final images.

​
Approving and rejecting individual photos

1

Open a photo

Navigate to an album and click any photo to open the editing view.
2

Approve or reject

Use the Approve button (Ctrl+P / Cmd+P) to mark the photo as approved, or the Reject button (Ctrl+X / Cmd+X) to mark it as rejected. The photo’s status badge updates immediately.
3

Change your mind

Clicking the same action again toggles the status back to neutral. You can switch between approved, rejected, and neutral at any time during an active review round.
Uploading a new revision of a photo resets its approval status to neutral so you always review the latest version intentionally.

​
Bulk approve and reject

When you need to act on many photos at once, use the bulk selection tools in the album view.
1

Select multiple photos

In the album grid, check the selection box on each photo you want to act on. You can also use Select All to select every photo in the album.
2

Apply bulk action

With photos selected, choose Approve Selected or Reject Selected from the bulk actions toolbar. The status updates for all selected photos simultaneously.
Use bulk approve to quickly greenlight an entire album, then open and reject specific photos individually. This is faster than reviewing every photo one by one when most of them are fine.

​
Photo selection packages

Selection packages define how many photos a client can choose from a project. This is ideal for session packages — for example, “Client chooses 10 photos from Look 1.”

​
Setting up a package

1

Create a package preset

Go to your account’s Studio settings and open the Packages tab. Create a new package and set its photo limit (e.g. 10 photos).
2

Assign the package to a project

Open the project’s Settings page and find the Photo Selection Package section. Choose the package you created from the dropdown and save.
3

Client makes their selects

When the project is sent for review, the client approves photos up to the package limit. Once they reach the limit, approving additional photos is blocked until they unapprove one.
4

Review the client's selects

As the photographer, you can see exactly which photos the client has approved. Use this list to prepare the delivery package.
Package limits are enforced through the API as well. If your client or an integration tries to approve more photos than the package allows, the request will be rejected with a validation error.

​
Approval status reference

StatusMeaning
Neutral (no badge)Not yet reviewed
ApprovedClient has selected this photo
RejectedClient has passed on this photo

​
API

You can read and update photo approval status using the Shootbin API.

​
Approve a photo

PATCH /api/projects/{project}/albums/{album}/photos/{photo}

curl -X PATCH https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"approved": true}'

​
Unapprove (reset) a photo

curl -X PATCH https://your-domain.tld/api/projects/PROJECT_ID/albums/ALBUM_ID/photos/PHOTO_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"approved": false}'
The API respects selection package limits. Approving a photo when the package limit has already been reached returns a 422 Unprocessable Entity response.