What are weekly contribution limits?
Some Assist types have weekly caps to ensure quality over quantity. Limits reset every Monday at 00:00 in your local timezone.
Why limits exist
Quality over quantity:
- Prevents rushed, low-quality contributions
- Encourages thoughtful, well-researched submissions
- Helps reviewers manage approval workload
Fair distribution:
- Gives everyone a chance to contribute
- Prevents one person from monopolizing points
- Balances participation across team
Prevent gaming:
- Limits spam submissions for points
- Ensures contributions are genuine opportunities
- Maintains program integrity
---
Limit values by Assist type
High-frequency Assists:
- Refer New Lead: 30/week (moderate sales activity)
- Partner Door-Opener: 10/week (controlled partnership outreach)
- Event Invitation: 20/week (event promotion campaigns)
Research-intensive Assists:
- Account Intel: 2/week (high-value research, takes time)
- Content Idea: 2/week (quality content over quantity)
Social Assists:
- Post Share: 5/week (prevent social spam)
HR Assists:
- Talent Referral: 3/week (thoughtful hiring referrals)
- Onboarding Buddy: 2/week (limited by actual new hires)
Unlimited Assists:
- All other Assist types: No limit (999/week effectively)
Note: Limits are configured in code, not editable in admin UI currently.
---
Reset schedule
When: Every Monday at 00:00 (midnight)
Timezone: Your local time (NOT UTC)
How it's calculated:
- System uses JavaScript Date object on your device
- Calculates start of current week (most recent Monday)
- Counts contributions since that Monday
Example:
- Today: Friday, January 17, 2025, 3:00 PM PST
- Week start: Monday, January 13, 2025, 12:00 AM PST
- Contributions counted: Jan 13-17
- Reset: Monday, January 20, 2025, 12:00 AM PST
International teams:
- Users in different timezones reset at different times
- Paris user resets 9 hours before California user
- This is intentional—prevents midnight submission races
---
Checking your limits
Before contributing:
1. Open Assist contribution form 2. System checks your contribution count for current week 3. Warning badge appears if close to limit:
Warning messages:
- Near limit: "Only 2 of 5 contributions remaining this week."
- At limit: "You've reached your weekly limit. Limit resets on Monday."
Badge colors:
- Yellow: 3 or fewer remaining
- Red: At limit (blocked)
Where you see warnings:
- Contribute drawer header
- Assist card (before opening form)
- Confirmation dialog (if you somehow bypass client check)
---
What happens at limit
Submission blocked:
- "Submit" button disabled
- Error message shown
- Form fields locked
Message shown: ``` You've reached your weekly limit of 5 contributions for this Assist.
Limit resets Monday, January 20 at 12:00 AM.
Why limits? They ensure quality submissions and fair distribution across the team. ```
Days until reset:
- Calculated dynamically: "Resets in 3 days"
- Or: "Resets tomorrow"
- Or: "Resets later today"
You can still:
- View Assist details
- Draft your contribution (future feature—save drafts)
- Contribute to other Assist types (if under their limits)
---
Tracking your contributions
Dashboard → Contribution History:
- Filter by Assist type
- Filter by date range (This Week)
- See count per Assist
Example: `` Refer New Lead: 8 contributions this week (30 limit) Post Share: 4 contributions this week (5 limit) Talent Referral: 1 contribution this week (3 limit) ``
No dedicated limit tracker yet (future feature: progress bar showing X/Y contributions).
---
Tips for managing limits
Plan your contributions:
- Don't submit all 30 leads on Monday—pace throughout week
- Save best opportunities for when you have time to write quality context
- Check limits Friday to avoid weekend surprise
Prioritize high-value contributions:
- If near limit, choose leads most likely to convert
- Quality > quantity always
- Reviewers more likely to approve well-researched submissions
Coordinate with team:
- If you're at limit but colleague has opportunity, pass it to them
- Rotate who contributes each week for fair point distribution
- Use Slack/email to share opportunities
Draft offline:
- Write contribution details in doc/note app
- Submit when ready and under limit
- Future feature: Save drafts in Teamwins
---
Troubleshooting
Says I'm at limit but I haven't contributed this week:
- Check you're viewing correct week (Monday-Sunday of current week)
- Verify you're in correct workspace (limits are per workspace)
- Hard refresh page (Ctrl+Shift+R) to clear cache
Limit not resetting on Monday:
- Check your device timezone settings (must be correct)
- Try signing out and back in
- If issue persists, contact admin (may be code issue)
Contributing to wrong Assist type:
- Each Assist type has separate limit
- If "Refer New Lead" is at limit, you can still do "Talent Referral"
- Check Assist type carefully before submitting
Limit seems too low:
- Limits are intentional for quality
- Contact admin if you have legitimate business case
- Admin may create additional Assist with higher limit (future feature)
---
For admins: Configuring limits
Current state: Limits are hardcoded in /src/services/weeklyLimitsService.ts
To change limits: 1. Developer must edit WEEKLY_LIMITS object in code 2. Redeploy application 3. No database configuration
Future feature: Admin UI to configure limits per Assist type
- Settings → Advanced Settings → Contribution Limits
- Edit limit values
- Apply per-workspace overrides
Workaround for now:
- Create multiple Assist variants with different limits
- Example: "Refer New Lead (High-Volume)" with 50/week limit
- Assign to top performers
---
Client-side enforcement
Important technical note:
Limits are currently advisory (client-side only). They're checked in the browser, not enforced server-side.
Implications:
- No database trigger to reject over-limit contributions
- Technically possible to bypass by manipulating client code
- Trust-based system
Future enhancement:
- Server-side validation in RPC functions
- Reject contributions exceeding limits
- Audit log for bypass attempts
For now: Limits rely on honest usage. Most users won't bypass—system serves its purpose of encouraging quality.
---
FAQs
Can I get my limit increased? Contact admin. They can create custom Assist with higher limit for specific users.
Do limits apply to admins? Yes—everyone has same limits, including admins.
What if I have 2 different "Refer New Lead" Assists? Limits are per Assist instance, not type. If workspace has "Sales Referral" and "Partner Referral" (both refer_new_lead type), each has separate 30/week limit.
Do failed/rejected contributions count against limit? Yes—limit counts all submissions, regardless of approval outcome.
Can I bank unused contributions for next week? No—limits don't roll over. Use them or lose them each week.
Why local time instead of UTC? Better UX—reset aligns with your work week. If UTC, some users would reset mid-workday.
---
Best practices
For members:
- Check limits before Friday (avoid weekend surprises)
- Pace contributions throughout week
- Focus on quality—reviewers appreciate well-researched submissions
For reviewers:
- Approve quality contributions quickly to encourage more
- Provide feedback on rejected submissions so members improve
- Limits reduce your workload—embrace them!
For admins:
- Monitor if limits are too restrictive (low utilization) or too loose (spam)
- Adjust in code as needed
- Communicate limit rationale to team
---
Next steps
- Submit contributions: Quick start - How to contribute
- Approval workflows - Getting contributions approved
- Troubleshooting contributions - Fix common issues
