Reputation System

How Cargo reputation is calculated and used

Reputation System

Cargo reputation reflects real-world performance. It helps users identify reliable Cargos and rewards publishers who maintain quality.

How Reputation Works

Every Cargo starts with a reputation score of 1.0 (on a 0.0-5.0 scale). The score changes based on job outcomes and user feedback.

Reputation Components

Score Changes

Positive Events

Negative Events

Reading Reputation

Score Ranges

What to Look For

When evaluating a Cargo, check:

1. Reputation score - Higher is better
2. Job count - More jobs = more data
3. Success rate - Percentage shown directly
4. Trend - Is it improving or declining?

Automatic Actions

The system takes automatic actions based on reputation:

Warnings

Demotions

Suspension

Recovery

Demoted or suspended Cargos can recover:

From Demotion

1. Fix underlying issues (bugs, performance)
2. Update Cargo with new version
3. Build positive track record
4. Trust level restores automatically at thresholds

From Suspension

1. Contact support to understand the issue
2. Submit remediation plan
3. Platform reviews and may reactivate
4. Cargo starts at Trust Level 0
5. Must earn back higher levels

For Publishers

Monitoring Reputation

Track your Cargo’s health:

1. Go to My Cargos → Select Cargo
2. Click Analytics tab
3. View:
   • Current reputation score
   • Score history graph
   • Success/failure breakdown
   • Recent events

Maintaining Good Reputation

1. Test thoroughly before publishing
2. Monitor actively for failures
3. Respond quickly to issues
4. Update regularly to fix bugs
5. Set realistic expectations in descriptions

Responding to Failures

When jobs fail:

1. Check error logs in your dashboard
2. Identify the root cause
3. Fix and publish an update
4. Failed jobs before the fix still count, but new successes will improve the score

For Users

Using Reputation to Choose

For critical applications:

• Prefer score 3.0+ with 1000+ jobs
• Check success rate is 95%+
• Verify trust level is 2 (Verified)

For experimentation:

• Score 2.0+ is usually fine
• 100+ jobs gives reasonable confidence
• Trust level 1 (Community) is acceptable

Reporting Issues

If a Cargo doesn’t work as expected:

1. Click Report Issue on the Cargo page
2. Describe what happened
3. Include job ID if available
4. Submit

Reports are reviewed by our team and may affect the Cargo’s reputation.

Reputation vs Trust Level

These are related but different:

A Cargo can have high trust (Level 2, signed) but poor reputation (buggy, unreliable). Conversely, a Level 1 Cargo might have excellent reputation through consistent performance.

Best Cargos have both: high trust level AND high reputation.

Frequently Asked Questions

How quickly does reputation change?

Score updates after every job. Major changes (demotion, suspension) are checked every 15 minutes.

Can I reset my Cargo’s reputation?

No, reputation carries forward. However, you can publish a new version of your Cargo (same ID, new container tag). The reputation continues but recent good performance will improve the score.

Do all job types count equally?

Yes, every job counts the same regardless of complexity or duration.

Is reputation public?

Yes, reputation score, job count, and success rate are visible to all users on the Cargo page.

Can I appeal a demotion or suspension?

Yes, contact support@archipelag.io with your Cargo ID and explanation.

Next Steps

{% end %}