Quick Setup Guide

Get Promy up and running in your Discord server in just 5 easy steps.

Web Dashboard

Prefer a visual interface? Use our web dashboard to configure your server!

How to Access the Dashboard

1. Visit: promy.gg/login
2. Login with Discord: Click "Login with Discord" to authenticate
3. Select Your Server: Choose which server you want to configure
4. Configure: Use the visual interface to set up your server

Dashboard Features

• Configuration Panel: Set bump channel, description, colors, tags, and more
• Live Preview: See your ad update in real-time as you make changes
• Channel/Role Search: Type to search through your channels and roles
• Image Upload: Drag and drop banner images (Promy Plus)
• Partnerships Management: Send, accept, deny, and manage partnership requests via web interface
• Audit Logs: Track all configuration changes and partnership actions with detailed history
• Analytics Page: View engagement metrics, charts, and performance data (Promy Plus)
• Export/Import: Save your configuration as JSON for backup

Partnerships Web Panel

Manage all your server partnerships through an intuitive web interface.

Features:

• Request Partnerships: Send partnership requests by entering a server ID
• Manage Incoming Requests: View, accept, or deny partnership requests from other servers
• View Active Partners: See all your current partnerships with server details
• Track Outgoing Requests: Monitor the status of partnership requests you've sent
• Toggle Incoming Requests: Enable or disable receiving new partnership requests
• Blacklist Servers: Block specific servers from sending you partnership requests
• View Partner Ads: Preview how partner ads will look in your channel

How to Access:

1. Login to the web dashboard at promy.gg/login
2. Select your server from the dashboard
3. Click on "Partnerships" in the sidebar navigation
4. Use the tabs to switch between Active Partners, Incoming Requests, and Outgoing Requests

Audit Logs Panel

Track every action taken on your server configuration with comprehensive audit logging.

What Gets Logged:

• Configuration Changes: Description, bump channel, unverified role, accent color, tags
• Partnership Actions: Requests sent/accepted/denied, partnerships removed, blacklist changes
• Banner Management: Banner uploads, approvals, rejections, removals
• Custom Emojis: Emoji updates, approvals, rejections
• Review Settings: Review channel and notification message changes
• Config Import/Export: Track when configurations are backed up or restored

Audit Log Features:

• User Attribution: See who made each change with username and avatar
• Timestamp Tracking: Precise timestamps for every action
• Before/After Comparison: View what changed with side-by-side comparison
• Advanced Filtering: Filter by user, action type, or specific field
• Pagination: Browse through historical logs with easy navigation
• Statistics Dashboard: See total actions, last 24 hours, and last 7 days activity

How to Access:

1. Login to the web dashboard at promy.gg/login
2. Select your server from the dashboard
3. Click on "Audit Logs" in the sidebar navigation
4. Use filters to find specific actions or users
5. Click on any log entry to expand and view detailed information

Server Partnerships

Create direct, permanent ad exchanges with specific servers.

What are Partnerships?

Server Partnerships allow you to create direct, permanent ad exchanges with specific servers. Unlike regular bumps that go to all servers, partnership ads stay permanently in your partner's channel!

Why Use Partnerships?

• Permanent Placement - Your ad stays in your partner's channel forever
• Auto-Updates - Ads refresh every 6 hours with latest stats
• Targeted Growth - Partner with servers in similar niches
• Build Relationships - Create lasting connections with communities
• Always Current - Stats update automatically even when you're offline

How Partnerships Work

1. Access Web Dashboard: Login to the web dashboard at promy.gg/login and select your server
2. Navigate to Partnerships: Click on "Partnerships" in the sidebar navigation
3. Send Request: Enter the target server ID and select a channel where their ad will appear. The channel must be visible to @everyone.
4. They Accept: The other server owner receives a notification and can accept/deny via their web dashboard
5. Ads Exchanged: Both server ads are posted in the selected channels and stay there permanently!
6. Auto-Updates: Partnership ads are automatically updated every 6 hours with your latest stats (member count, ratings, boosts, server name, icon, description, etc.) so they never look outdated!
7. Manage Anytime: View, manage, and remove partnerships through the web dashboard

Managing Your Partnerships

Active Partnerships

View all your current active partnerships with detailed server information.

Incoming Partnership Requests

Review and respond to partnership requests from other servers.

Outgoing Partnership Requests

Track the status of partnership requests you've sent to other servers.

All Commands

Complete command reference for Promy.

Advertising Commands

Discovery Commands

Promy Plus Commands

Utility Commands

Promy Plus Features

Unlock enhanced advertising features and detailed analytics.

Promy Plus Features

How to Get Promy Plus

1. Join Our Support Server: Head to our support server to purchase Promy Plus keys
2. Redeem Your Key: Use /redeem in your server with your key
3. Enjoy Promy Plus Features: All features activate immediately!

Pricing

You can purchase a monthly subscription for $3.99, and a lifetime key for $19.99.

Purchase a Promy Plus key

Frequently Asked Questions

Q: Is Promy Plus per-user or per-server?
A: Promy Plus is per-server. Whether you choose a subscription or a one-time purchase, it applies to that specific server.

Q: Does Promy Plus expire?
A: One-time Promy Plus never expires and includes lifetime access. Subscriptions renew monthly unless canceled.

Q: Can I transfer Promy Plus to another server?
A: No, Promy Plus is tied to the specific server where it was redeemed.

Q: Do I need Promy Plus to use partnerships?
A: No! Partnerships are free for all users.

How Promy Works

Understanding the network effect and advertising cycle.

The Advertising Cycle

1. Setup Your Bump Channel: Choose a channel visible to @everyone where ads will appear
2. Create Your Server Ad: Write an engaging description and customize with colors and banners
3. Bump Your Server: When you run /bump, your ad broadcasts to all connected servers instantly
4. Receive Ads: Other servers' ads appear in your bump channel, creating fair exchange
5. Grow Together: The more servers that join, the more exposure everyone gets!

Server Tags System

• Free Users: Up to 3 tags in gray color
• Promy Plus Users: Up to 5 tags with custom colors (Blurple, Gray, Green, Red)
• Tags help users quickly identify server types (Gaming, Anime, Music, etc.)
• Tags appear as colored buttons under server information

Bump System

Manual Bumping

• Run /bump to advertise your server
• 3-hour cooldown between bumps
• Get reminded when cooldown expires
• 10-second server cooldown prevents spam

Bump Reminders

• Get notified when you can bump again (2 hours after last bump)
• Reminder sent in the same channel where you bumped
• Multiple users who try to bump during cooldown will all be notified

Auto-Bump (Promy Plus)

• Your server is automatically advertised every 2 hours
• No manual work required
• Maximum network exposure 24/7

Cooldowns & Limits

Fair Usage Policy

Why The Network Works

• Mutual Benefit: Every server gives and receives exposure equally
• Scalable Growth: As the network grows, everyone benefits from increased reach
• Targeted Audience: Reach Discord users actively looking for new communities
• No Cost Barrier: Core features are free for all servers
• Quality Control: Fair usage policies keep the network valuable

Advanced Configuration

Deep dive into advanced bot configuration options and customization features.

Custom Emoji Configuration (Promy Plus)

Replace default bot emojis with your server's custom emojis for a personalized advertising experience.

How to Use Custom Emojis

1. Ensure Promy Plus is active on your server
2. Bot must be in the server containing your custom emojis
3. Use format: <:emoji_name:emoji_id> in descriptions
4. For animated emojis: <a:emoji_name:emoji_id>

Color Customization

Customize your advertisement's accent color to match your server's branding.

• Use hex color codes (e.g., #1db856, #FF5733)
• Color appears on embed sidebar and accent elements
• Use the web dashboard color picker for visual selection
• Color updates apply to all future bumps and partnership ads

Banner Image Setup (Promy Plus)

Supported Formats

• PNG, JPG, JPEG formats
• Maximum file size: 8MB
• Recommended dimensions: 1920x1080 (16:9 aspect ratio)
• Minimum resolution: 800x450 for clarity

Best Practices for Banner Images

• Use high-resolution images that represent your server's theme
• Avoid excessive text in images (use description field instead)
• Ensure images comply with Discord ToS and Promy guidelines
• Test on both dark and light Discord themes
• Consider mobile viewing - important details should be centered

Review Notification Configuration (Promy Plus)

Get instant notifications when users leave reviews for your server.

• Configure channel via the web dashboard
• Notifications sent within 60 seconds of new review
• Includes reviewer username, rating, and review text
• Helps you respond quickly to feedback

Server Discovery

Explore how Promy's powerful discovery system connects users with communities that match their interests.

Search Functionality

The /search command allows users to find servers based on tags and categories.

How to Use Search

1. Use /search tags:[tag1,tag2,tag3] to search by tags
2. Separate multiple tags with commas for better results
3. Results are ranked by relevance and activity
4. Each search has a 5-minute cooldown per user

AI-Powered Recommendations

Promy Plus servers can access AI-powered server recommendations based on their existing tags and community profile.

• Smart Matching: AI analyzes your server's tags to find similar communities
• Partner Discovery: Find potential partnership opportunities
• Growth Insights: Discover which servers attract similar audiences
• Real-time Updates: Recommendations refresh as your server evolves

Featured Server System

High-quality, active servers may be featured in Promy's discovery rotation.

Requirements for Featured Status

• Active Promy Plus subscription
• Minimum 100 members
• Positive review average (4+ stars)
• Complete server setup (description, tags, banner)
• Good standing with no guideline violations

Tag Optimization Strategies

Choosing the right tags is crucial for discovery visibility.

Review System

Build trust and credibility through Promy's comprehensive server review system.

Leaving Reviews

Users can leave reviews for servers they've joined through Promy.

How to Leave a Review

1. Use /review command in the target server
2. Select a star rating (1-5 stars)
3. Write a review (1-500 characters)
4. Submit - review appears on server's profile immediately

Review Restrictions

• One review per server per user
• Cannot review your own server
• Server must have Promy installed and configured
• 10-minute cooldown for editing reviews

Changing or Deleting Reviews

If you have already submitted a review, you can change it or delete it at any time.

1. Use /review with random rating and text command in the server you already reviewed
2. Promy will display your current review
3. Click "Change Review" to update your rating or text
4. Click "Delete Review" to remove it permanently

Managing Reviews (Server Owners)

Server owners with Promy Plus can receive notifications when new reviews are posted.

Review Notifications Setup

1. Ensure Promy Plus is active
2. Login to the web dashboard at promy.gg/login
3. Select the channel for review notifications in the configuration panel
4. Grant bot "Send Messages" permission in that channel

How Reviews Impact Your Server

Review Moderation

Promy staff reviews flagged reviews to ensure quality and fairness.

• Report inappropriate reviews via support server
• Include screenshot evidence when reporting
• Moderators review reports within 24-48 hours
• Removed reviews do not count toward server's average rating

Engagement & Leaderboard

Track engagement metrics and compete on global leaderboards to showcase your server's growth.

Engagement Tracking

Promy automatically tracks various engagement metrics for your server.

Tracked Metrics

• Total Bumps: Number of times your server has been bumped
• Partnership Count: Active partnerships with other servers
• Review Score: Average star rating from user reviews
• Member Growth: Tracking new members from Promy referrals
• Activity Score: Overall engagement and network participation

Leaderboard System

Compete with servers across the Promy network on various leaderboards.

Leaderboard Categories

Ranking Benefits

Top-ranked servers receive special perks and visibility boosts.

• Top 10: Featured badge on server profile
• Top 5: Priority in discovery search results
• Top 3: Featured rotation in Promy support server
• #1 Ranked: Special announcement and highlight for 24 hours

Architecture

Technical overview of Promy's robust, scalable Discord bot architecture.

Technology Stack

Promy is built with modern, production-grade technologies.

• Runtime: Node.js (JavaScript/ES6+)
• Discord API: discord.js v14
• Database: MongoDB with Mongoose ODM
• Hosting: Cloud infrastructure with 99.9% uptime SLA
• API Layer: RESTful design with rate limiting

Core System Components

Data Architecture

Promy uses a document-based database structure optimized for Discord guilds.

Key Collections

• Guild Configs: Server settings, bump channels, premium status
• Partnerships: Partnership relationships and ad synchronization
• Reviews: User-submitted reviews and ratings
• Analytics: Engagement metrics and leaderboard data
• Premium Keys: Promy Plus activation and expiration tracking

Scalability & Performance

Built to handle thousands of concurrent servers efficiently.

• Horizontal scaling with load balancing
• Database indexing for sub-100ms query times
• Caching layer for frequently accessed data
• Async/await patterns for non-blocking operations

Background Services

Explore the 30+ automated services that power Promy's functionality 24/7.

Advertising Services

Partnership Services

• Partner Ad Sync: Updates partnership advertisements every 6 hours
• Partner Channel Monitor: Validates channel permissions and accessibility
• Partnership Request Manager: Handles incoming/outgoing partnership requests

Premium Services

Monitoring & Maintenance

• Bump Channel Audit: Validates bump channel permissions hourly
• Invite Link Checker: Ensures server invite links are valid (daily)
• Message Expiration Service: Cleans up temporary messages
• Bot Stats Tracker: Monitors performance and uptime metrics
• Emoji Validation: Verifies custom emoji accessibility

Discovery & Engagement

• Featured Server Rotation: Cycles featured servers every 4 hours
• Tag Sync: Updates tag indexes for search optimization
• Leaderboard Updater: Recalculates rankings every 15 minutes
• Review Sync Service: Processes and displays new reviews

Cleanup Services

• DM Cleanup: Removes old direct messages from bot
• Guild Config Cleanup: Archives configs for deleted servers
• Admin Panel Cleanup: Removes expired admin messages

Rate Limits & Cooldowns

Understanding Promy's rate limiting system helps prevent spam and ensures fair usage across all servers.

Command-Specific Cooldowns

Command	Cooldown	Scope
/bump	2 hours	Per server
/search	5 minutes	Per user
Per user

Auto-Bump Frequency (Promy Plus)

Automatic bumps occur every 2 hours for Promy Plus servers.

• Runs at fixed intervals (no randomization)
• Unaffected by manual bump cooldown
• Continues even if server is offline temporarily
• Stops if bump channel becomes inaccessible

Partnership Limits

Review System Limits

• One review per server per user (lifetime)
• 1-500 character limit per review
• No cooldown between reviewing different servers
• Cannot delete/edit reviews (contact support for changes)

Global Rate Limits

Discord API rate limits apply to all bots. Promy implements smart throttling to stay within limits.

Cooldown Management

Cooldowns cannot be bypassed or reset by users. They exist to:

• Prevent spam and maintain content quality
• Ensure fair distribution of advertising visibility
• Protect Discord API resources from overuse
• Maintain network performance for all users

Permissions Guide

Comprehensive guide to Discord permissions required for Promy's features.

Required Bot Permissions

Promy needs the following permissions to function properly:

Permission	Required For
View Channels	Access bump and partnership channels
Send Messages	Post bump ads and partnership messages
Embed Links	Display formatted advertisements
Read Message History	Track and update previous ads
Add Reactions	Interactive features and engagement tracking
Manage Roles	Assign Promy Plus role (optional)

User Command Permissions

Different commands require different user permission levels.

Administrator/Manage Server Required

• Web Dashboard - Configure bot settings and manage partnerships

All Users Can Access

• /bump - Bump the server
• /search - Search for servers
• /review - Leave a review
• /help - Get help information

Channel-Specific Permissions

Ensure Promy has these permissions in configured channels:

Permission Troubleshooting

Common Issues

• "Missing Permissions" error: Bot role is below channel permission overrides
• "Cannot send messages": Channel permissions deny the bot access
• "Slash commands not appearing": Application commands disabled in server settings

Role Hierarchy Best Practices

For optimal functionality:

1. Place Promy's role near the top of your role list
2. Ensure it's above any "Unverified" or restricted roles
3. If using Promy Plus role, place it below the bot's role
4. Avoid giving Promy "Administrator" permission (security risk)

Performance Optimization

Maximize your server's growth and visibility with strategic optimization techniques.

Bump Timing Optimization

Strategic bump timing can significantly increase visibility.

Best Times to Bump

• Peak Hours: 6-10 PM in your target timezone
• Weekends: Saturday and Sunday afternoons
• Avoid: Late night (2-6 AM) when activity is lowest

Description Best Practices

Your description is the first thing potential members see - make it count!

Winning Description Formula

1. Hook (1-2 lines): Grab attention with your unique selling point
2. Features (3-5 bullet points): What makes your server special
3. Call-to-Action: Encourage users to join
4. Visual Appeal: Use emojis strategically (not excessively)

Example Structure

Tag Selection Strategy

Partnership Growth Strategy

Strategic partnerships can double your exposure.

Ideal Partner Criteria

• Similar size (within 50% of your member count)
• Complementary niche (not direct competitor)
• Active Promy Plus subscription (for auto-updating ads)
• Similar activity level and engagement

Review Management for Growth

Positive reviews dramatically increase conversion rates.

Building Review Momentum

1. Ask engaged members to leave honest reviews
2. Respond to feedback (through announcements)
3. Address negative reviews by improving your server
4. Aim for 10+ reviews before heavily promoting

Using Analytics for Optimization

Promy Plus analytics reveal what's working and what needs improvement.

Key Metrics to Track

• Bump Performance: Join rate per bump session
• Partnership ROI: Which partnerships drive most traffic
• Peak Times: When your ads get most clicks
• Review Trends: Common praise and complaints

Security & Moderation

Protect your server and maintain quality content with proper security practices.

Permission Security

Proper permission configuration prevents abuse and unauthorized access.

Recommended Permission Setup

• Grant only required permissions (see Permissions Guide)
• Use channel-specific permission overrides
• Restrict web dashboard access to trusted admins only
• Monitor role hierarchy to prevent escalation

Bump Channel Security

Configure your bump channel to prevent spam and maintain quality.

Best Practices

1. Dedicated Channel: Create a channel specifically for Promy bumps
2. Unverified Role Protection: Prevent unverified users from viewing bump channel
3. Read-Only: Disable member message permissions (optional)
4. Slowmode: Apply slowmode to prevent chat spam

Content Moderation

Promy enforces strict content policies to maintain network quality.

Prohibited Content

• NSFW content in server descriptions or tags
• Scam links, malware, or phishing attempts
• Hate speech, harassment, or discriminatory content
• Spam servers, raid coordination, or bot farms
• Discord ToS violations of any kind

Partnership Verification

Vet potential partners to avoid problematic partnerships.

Partnership Safety Checklist

• Visit the partner server before accepting
• Check server rules and content for ToS compliance
• Verify they have active moderation
• Review their Promy rating and reviews
• Ensure partnership channel is appropriate

Review Moderation Policy

How Promy handles review moderation and disputes.

• All reviews are screened for guideline compliance
• Fake reviews, spam, or abusive content is removed
• Server owners can report problematic reviews
• Review disputes resolved by Promy staff within 48 hours

Account Security

Protect your Discord account to prevent unauthorized bot access.

Security Best Practices

1. Enable Discord 2FA (two-factor authentication)
2. Never share your Discord token or credentials
3. Regularly audit server permissions and roles
4. Remove inactive or untrusted administrators
5. Monitor server audit logs for suspicious activity

Reporting Security Issues

If you discover a security vulnerability or abuse:

• Open a ticket in Promy Support Server
• Provide detailed information and evidence (screenshots)
• Do not publicly disclose vulnerabilities before reporting
• Allow 72 hours for staff response and investigation

Growth Strategies

Proven strategies to accelerate your server's growth using Promy's full feature set.

Quick Wins (First 7 Days)

Foundational steps for immediate growth impact.

30-Day Growth Plan

Structured approach to building momentum.

Week 1: Foundation

• Complete Promy setup with optimized description
• Add strategic tags (2-3 specific, 1 broad)
• Begin bumping during peak hours
• Partner with 3 similar-sized servers

Week 2: Optimization

• Analyze which tags drive most traffic
• A/B test different descriptions (change weekly)
• Expand partnerships to 5-7 servers
• Collect first 10 reviews

Week 3: Scaling

• Consider Promy Plus for auto-bump and analytics
• Add custom banner to stand out
• Target partnerships with slightly larger servers
• Aim for 4+ star average rating

Week 4: Refinement

• Use analytics to identify peak performance times
• Refine description based on what converts best
• Seek featured server status (if eligible)
• Focus on retention (not just acquisition)

Advanced Growth Tactics

Cross-Promotion Strategy

Leverage Promy with other growth channels:

• Include Promy link in other listing sites
• Mention your Promy rating in recruitment posts
• Use leaderboard rankings in server announcements
• Share partnership milestones to attract more partners

Seasonal Optimization

Adjust your strategy based on timing:

• Summer (June-August): Higher Discord activity, increase bump frequency
• Back to School (September): Students looking for communities, emphasize social aspects
• Holidays (November-December): Highlight events, giveaways, festive activities
• New Year (January): "Fresh start" messaging, beginner-friendly emphasis

Retention Over Acquisition

Growth isn't just about getting members - it's about keeping them.

Retention Strategies

• Welcome new members from Promy personally
• Create onboarding flow that highlights your best channels
• Host events within first week of members joining
• Use bump channel as engagement hub, not just ads
• Monitor which Promy partnerships bring highest-quality members

Measuring Success

Track these KPIs to evaluate your growth strategy:

Metric	Good Target
Joins per bump	3-5 for small servers, 10+ for established
Average review rating	4.0+ stars
Partnership reciprocation	60%+ acceptance rate
7-day retention	50%+ of new members stay

Success Stories

Learn from servers that achieved rapid growth with Promy.

Troubleshooting

Encountering issues with Promy? Visit our comprehensive troubleshooting guide.

Visit Troubleshooting Guide

Comprehensive solutions for setup, commands, premium features, and errors

Quick Troubleshooting Tips

Issue Categories

Our troubleshooting guide covers:

• Setup Issues: Bot configuration, channels, permissions
• Command Issues: Bumps, search, partnerships, reviews
• Promy Plus: Premium features, banners, analytics
• Errors: Permission errors, API issues, blacklists
• General Questions: Features, limits, best practices

Getting Help

We're here to help you get the most out of Promy!

Join Our Support Server

The fastest way to get help is by joining our Discord support server!

Join Support Server

Common Issues

Ads Not Appearing?

• Check your bump channel permissions - must be visible to @everyone
• Bot needs "View Channel" and "Send Messages" permissions
• Verify setup is complete via the web dashboard

Can't Bump?

• Wait for the 3-hour cooldown to expire
• You'll get a reminder when ready
• Make sure the bot is online

Promy Plus Key Not Working?

• Verify you redeemed the key in the correct server
• Check if the key was already used
• Contact support if issues persist

Bot Not Responding?

• Check that bot has "Use Application Commands" permission
• Verify bot role has required permissions
• Try the command in a different channel

Contact Support

If you can't find an answer to your question:

1. Join the support server (fastest response)
2. Check existing documentation pages
3. Ask in community channels
4. Open a support ticket for complex issues

Feature Requests

Have an idea for a new feature? We'd love to hear it!

• Post in our support server's suggestions channel
• Vote on existing suggestions
• Discuss ideas with the community
• Developers actively review all suggestions

Report Issues

Found a bug or exploit?

• Report immediately in support server
• Use the bug report channel
• Provide detailed information
• Include screenshots if possible
• Be responsible - don't abuse exploits