Skip to main content

đŸ“Ļ Product Settings

Configure whether product command responses are shown as ephemeral messages (private) or regular messages (public).

Configuration Overview​

ProductSettings:
  ListEph: true
  CreateEph: true
  DeleteEph: true
  VersionEph: true

Setting Details​

All product settings control whether Discord slash command responses are sent as ephemeral messages (only visible to the command user) or as regular messages (visible to everyone in the channel).

ListEph​

Type: boolean | Required: Yes | Default: true

Controls whether /product list command responses are ephemeral.

ListEph: true   # Only command user sees the product list response
ListEph: false  # Everyone in channel sees the product list response

When to use true:

  • Keep product information private
  • Reduce channel clutter
  • Maintain professional appearance
  • Protect sensitive product details

When to use false:

  • Allow team collaboration on product lists
  • Enable public product showcasing
  • Facilitate discussions about products

CreateEph​

Type: boolean | Required: Yes | Default: true

Controls whether /product create command responses are ephemeral.

CreateEph: true   # Only command user sees the creation confirmation
CreateEph: false  # Everyone in channel sees the creation confirmation

When to use true:

  • Keep product creation private
  • Prevent spam in busy channels
  • Maintain clean channel history

When to use false:

  • Announce new products to the team
  • Enable team awareness of product additions
  • Create public product launch announcements

DeleteEph​

Type: boolean | Required: Yes | Default: true

Controls whether /product delete command responses are ephemeral.

DeleteEph: true   # Only command user sees the deletion confirmation
DeleteEph: false  # Everyone in channel sees the deletion confirmation

When to use true:

  • Keep deletions private
  • Avoid unnecessary notifications
  • Maintain professional appearance

When to use false:

  • Announce product removals to team
  • Enable team oversight of deletions
  • Create audit trail in channel

VersionEph​

Type: boolean | Required: Yes | Default: true

Controls whether /product version command responses are ephemeral.

VersionEph: true   # Only command user sees the version change confirmation
VersionEph: false  # Everyone in channel sees the version change confirmation

When to use true:

  • Keep version updates private
  • Reduce notification noise
  • Maintain clean channels

When to use false:

  • Announce version updates to users
  • Enable team awareness of changes
  • Create public update logs

Example Configurations​

ProductSettings:
  ListEph: true    # Keep product lists private
  CreateEph: true  # Private creation confirmations
  DeleteEph: true  # Private deletion confirmations
  VersionEph: true # Private version updates

Best for:

  • Professional environments
  • Large Discord servers
  • Sensitive product information
  • Clean channel appearance

Public Announcements​

ProductSettings:
  ListEph: false   # Public product lists
  CreateEph: false # Announce new products
  DeleteEph: false # Announce product removals
  VersionEph: false # Announce version updates

Best for:

  • Small teams
  • Collaborative environments
  • Public product showcasing
  • Transparent management

Mixed Approach​

ProductSettings:
  ListEph: true    # Keep lists private
  CreateEph: false # Announce new products
  DeleteEph: true  # Keep deletions private
  VersionEph: false # Announce version updates

Best for:

  • Medium-sized teams
  • Balanced transparency
  • Selective announcements
  • User engagement

Development Environment​

ProductSettings:
  ListEph: false   # Public for team review
  CreateEph: false # Announce test products
  DeleteEph: false # Track cleanup activities
  VersionEph: false # Track version changes

Best for:

  • Development servers
  • Testing environments
  • Team collaboration
  • Debugging activities

Impact on User Experience​

Ephemeral Messages (true)​

Advantages:

  • ✅ Reduces channel clutter
  • ✅ Keeps sensitive information private
  • ✅ Professional appearance
  • ✅ Reduces notification spam
  • ✅ Allows personal workflow

Disadvantages:

  • ❌ Limits team collaboration
  • ❌ Reduces transparency
  • ❌ No public announcements
  • ❌ Harder to track changes

Public Messages (false)​

Advantages:

  • ✅ Promotes team awareness
  • ✅ Creates public announcements
  • ✅ Enables collaboration
  • ✅ Provides audit trail
  • ✅ Increases engagement

Disadvantages:

  • ❌ Creates channel clutter
  • ❌ May spam notifications
  • ❌ Exposes sensitive information
  • ❌ Less professional appearance

Security Considerations​

Information Disclosure​

# Secure setup - prevents information leakage
ProductSettings:
  ListEph: true    # Product names stay private
  CreateEph: true  # Creation details private
  DeleteEph: true  # Deletion details private
  VersionEph: true # Version info private

Team Transparency​

# Transparent setup - enables team awareness
ProductSettings:
  ListEph: false   # Team can see all products
  CreateEph: false # Team knows about new products
  DeleteEph: false # Team aware of removals
  VersionEph: false # Team tracks version changes

Best Practices​

Channel Management​

  1. Use private channels for management commands when using public messages
  2. Create dedicated channels for product announcements
  3. Set channel permissions appropriately for your team
  4. Consider channel purpose when choosing ephemeral settings

Team Communication​

  1. Document decisions about ephemeral settings
  2. Train team members on message visibility
  3. Review settings regularly based on team feedback
  4. Adjust based on server size and activity level

Professional Environment​

# Recommended for business use
ProductSettings:
  ListEph: true    # Keep product info confidential
  CreateEph: true  # Prevent announcement spam
  DeleteEph: true  # Maintain professional appearance
  VersionEph: true # Reduce notification noise

Development Environment​

# Recommended for dev teams
ProductSettings:
  ListEph: false   # Enable team review
  CreateEph: false # Track new test products
  DeleteEph: false # Monitor cleanup activities
  VersionEph: false # Track version progression

Troubleshooting​

Common Issues​

Messages not appearing:

  • Check if ephemeral is set to true (only command user sees)
  • Verify user permissions to see channel
  • Confirm bot has proper permissions

Too much channel spam:

  • Set ephemeral settings to true
  • Use dedicated management channels
  • Review team usage patterns

Team missing announcements:

  • Set relevant settings to false
  • Use notification channels
  • Document important changes separately

Testing Settings​

  1. Test with different users - Verify visibility settings
  2. Try different channels - Check permission interactions
  3. Monitor channel activity - Assess spam levels
  4. Get team feedback - Ask about preferred visibility

Migration Tips​

Changing from Public to Private​

  1. Announce the change to your team
  2. Document the decision and reasoning
  3. Provide alternative communication methods
  4. Monitor team adaptation to new workflow

Changing from Private to Public​

  1. Prepare team members for increased visibility
  2. Clean up channels before enabling public messages
  3. Set expectations about channel usage
  4. Monitor channel activity for spam issues

These settings work closely with: