Usage Limits

Understand and manage your monthly photo limits and overage charges.

Overview

Each subscription plan includes:

• Monthly photo allowance (or lifetime for free plan)
• Usage tracking per billing cycle
• Overage handling options
• Usage notifications

Free Plan Differences

The Developer Free Plan works differently: it provides a lifetime quota of 100 photos (not monthly) and does not support email features. Learn more about free plan limitations.

Monthly Photo Limit

How It Works

Your plan includes a set number of photos per month. Limits vary by plan — see current pricing for details.

Billing Cycle

Photo limits reset on your subscription renewal date, not the calendar month.

Counting Photos

Each photo submitted counts toward your limit:

• One-time request photos
• Permanent Link submissions
• All photo slots

Viewing Usage

Dashboard Widget

The dashboard displays:

• Photos used this period
• Photos remaining
• Usage percentage
• Billing period dates

Detailed Usage

To view detailed usage:

1. Go to your Dashboard
2. View the usage widget
3. Click for more details

Usage History

Track usage over time:

• Previous billing periods
• Monthly trends
• Overage history

Overage Handling

Two Options

Setting	Behavior
Block uploads	Photos blocked when limit reached
Allow overage	Extra photos charged per unit

Configuring Overage

1. Go to Settings → General
2. Find Usage Limits section
3. Toggle Block photo uploads when limit is reached
4. Save changes

Overage Pricing

When overage is allowed:

• Additional photos charged at overage rate
• Rate depends on your plan
• Charged at end of billing cycle

Overage Billing

Monthly Invoicing

Overage charges are billed monthly, regardless of whether you have a monthly, annual, or lifetime plan.

Minimum threshold: We only invoice when your overage amount reaches €10 or more. Smaller amounts accumulate until they reach this threshold.

Example: If your overage in January is €7, you won't receive an invoice. If February adds €5 more, you'll be invoiced €12 (€7 + €5) at the end of February.

Usage Notifications

Automatic Alerts

The system sends notifications at:

Threshold	Notification
70%	Warning: approaching limit
90%	Alert: near limit
100%	Limit reached

Notification Recipients

Notifications go to:

• Workspace owner
• Users with admin role
• Email delivery

Managing Notifications

Notification preferences are automatic. To avoid alerts:

• Upgrade your plan
• Enable overage charges
• Monitor usage proactively

Best Practices

Stay Within Limits

1. Monitor dashboard regularly
2. Plan for busy periods
3. Consider upgrading before hitting limits

For Seasonal Businesses

• Upgrade during peak seasons
• Downgrade during slow periods
• Track historical patterns

For Growing Teams

• Start with appropriate plan
• Monitor usage trends
• Upgrade proactively

Upgrading Your Plan

When to Upgrade

Consider upgrading when:

• Regularly hitting 80%+ usage
• Overage charges are significant
• Need additional features

How to Upgrade

1. Go to Subscription page
2. Click Upgrade Plan
3. Select new plan
4. Confirm upgrade

Changes take effect immediately.

FAQ

What happens when I hit the limit?

If blocking is enabled:

• New photo uploads are rejected
• Existing photos remain accessible
• Customers see an error message

If overage is enabled:

• Photos continue uploading
• Extra charges apply
• No interruption to service

Do unused photos roll over?

No, unused photos do not roll over to the next billing cycle. Each period resets to your plan's full allowance.

Can I see who uploaded photos?

Yes, each submission shows:

• Submission date/time
• Photo count
• Source (request type)

How are overage charges calculated?

Overage charges are:

• Calculated per photo over limit
• Based on your plan's overage rate
• Invoiced monthly (even for annual/lifetime plans)
• Only charged when total reaches €10 or more

Free Plan Limitations

The Developer Free Plan is designed for testing and evaluation purposes. It has specific restrictions that differ from paid plans.

Lifetime Photo Quota

Unlike paid plans with monthly allocations:

• 100 photos total (lifetime limit, not per month)
• Counter never resets
• No monthly billing cycles
• Usage tracked from account creation

Quota Tracking

View your lifetime usage in the Dashboard widget. The usage object in API responses includes is_lifetime_quota: true for free plan users.

Email Features Disabled

Free plan users cannot send photo requests via email:

Feature	Free Plan	Starter+ Plans
Email photo requests	❌ Not available	✅ Available
recipient_email API parameter	❌ Prohibited (422 error)	✅ Allowed
send_email API parameter	❌ Prohibited (422 error)	✅ Allowed

API Error Response:

{
  "message": "The recipient email field is prohibited.",
  "errors": {
    "recipient_email": [
      "Email features are not available on the free plan. Upgrade to send photo requests via email."
    ]
  }
}

Workaround: Share the request_url from API responses manually (via SMS, chat, messaging apps, etc.).

Stats API Response Differences

When calling GET /api/v1/stats on the free plan, the response includes:

{
  "data": {
    "plan": {
      "name": "Developer-free",
      "email_enabled": false
    },
    "usage": {
      "photos_used": 45,
      "photos_included": 100,
      "photos_remaining": 55,
      "billing_period_start": null,
      "billing_period_end": null,
      "is_lifetime_quota": true
    }
  }
}

Key differences:

• plan.email_enabled: false
• usage.is_lifetime_quota: true
• usage.billing_period_start: null
• usage.billing_period_end: null

Upgrading to Paid Plans

To unlock email features and monthly quotas:

1. Go to Subscription page
2. Select Starter or higher plan
3. Complete checkout
4. Email features activate immediately
5. Quota switches to monthly allocation

Migration Note

When upgrading from free to paid, your lifetime photo counter resets, and you start fresh with a monthly allocation.

Related Pages

• Workspace Settings - Configure limits
• Dashboard - View usage widget
• API Reference - API documentation