> ## Documentation Index
> Fetch the complete documentation index at: https://veronicadocs.xo.je/llms.txt
> Use this file to discover all available pages before exploring further.

# Ping on Join

> Automatically ping new members when they join your server.

# Ping on Join

Automatically ping (mention) new members when they join your server. The ping is sent to a designated channel and automatically deleted after 5 seconds, ensuring members receive a notification without cluttering the channel.

## Quick Setup

<Steps title="Onboarding Workflow">
  <Step title="Configure Welcome System">
    Ping on Join is part of the welcome system configuration.

    ```bash theme={null}
    /welcome setup
    ```

    <Check>Welcome panel initialized.</Check>
  </Step>

  <Step title="Enable Ping on Join">
    Use the welcome panel to enable ping on join and set the destination channel.
    <Check>Notification module toggled to ON.</Check>
  </Step>

  <Step title="Verification Test">
    Have a test account join to verify the ping and auto-deletion.
    <Check>Ping and 5s cleanup cycle confirmed.</Check>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Auto-Roles" icon="user-plus" href="/setups/auto-role">
    Combine pings with automatic role assignment for new users.
  </Card>

  <Card title="Welcome Messages" icon="hand-wave" href="/setups/welcome">
    Create a complementary greeting to follow the notification.
  </Card>
</CardGroup>

<Info>
  Ping on Join is configured through the **Welcome System**. It's a separate feature from welcome messages and can be enabled independently.
</Info>

## How It Works

When a new member joins:

<Steps>
  <Step title="Member Joins">
    A new member joins your Discord server.
  </Step>

  <Step title="Ping Sent">
    Veronica sends a message mentioning the member in the configured channel.
  </Step>

  <Step title="Notification Received">
    The member receives a Discord notification for the mention.
  </Step>

  <Step title="Auto-Delete">
    After 5 seconds, the ping message is automatically deleted.
  </Step>
</Steps>

## Configuration

Ping on Join is configured through the Welcome System:

```bash theme={null}
/welcome setup
```

**Settings:**

* **Enabled**: Toggle ping on join on/off
* **Channel**: Set which channel receives the pings

## Use Cases

<CardGroup cols={2}>
  <Card title="Member Notifications" icon="bell">
    Ensure new members get a notification immediately upon joining, even if they don't read the welcome channel.
  </Card>

  <Card title="Staff Alerts" icon="user-shield">
    Ping new members in a staff channel to alert moderators of new joins.
  </Card>

  <Card title="Verification Prompt" icon="shield-check">
    Use pings to draw attention to verification instructions or rules.
  </Card>

  <Card title="Community Engagement" icon="users">
    Encourage existing members to greet newcomers by pinging in a welcome channel.
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Use a Dedicated Channel">
    Create a `#welcome` or `#arrivals` channel specifically for pings to avoid disrupting other conversations.
  </Accordion>

  <Accordion title="Combine with Welcome Messages">
    Use ping on join alongside welcome messages for maximum visibility and engagement.
  </Accordion>

  <Accordion title="Consider Server Size">
    For very large servers with frequent joins, ping on join may cause notification spam. Use sparingly or disable.
  </Accordion>

  <Accordion title="Set Channel Permissions">
    Make the ping channel read-only for members to prevent chat clutter.
  </Accordion>
</AccordionGroup>

## Auto-Delete Behavior

The ping message is automatically deleted after **5 seconds** to:

* **Prevent Clutter**: Keep channels clean without manual cleanup
* **Maintain Privacy**: Remove member mentions from public view quickly
* **Reduce Spam**: Avoid overwhelming channels with join pings

<Note>
  The 5-second delay ensures the member receives the notification before the message is deleted.
</Note>

## Example Workflow

<Steps>
  <Step title="Create Welcome Channel">
    Create a channel: `#welcome`
  </Step>

  <Step title="Configure Ping on Join">
    Run `/welcome setup` and enable ping on join for `#welcome`
  </Step>

  <Step title="Set Permissions">
    Make `#welcome` read-only for `@everyone`
  </Step>

  <Step title="Add Welcome Message">
    Optionally add a welcome message in the same channel
  </Step>

  <Step title="Test">
    Have a test account join to verify the ping works
  </Step>
</Steps>

## Combining with Other Features

Ping on Join works seamlessly with other welcome features:

<CardGroup cols={2}>
  <Card title="Welcome Messages" icon="message">
    Send a welcome message in the same channel as the ping.
  </Card>

  <Card title="Auto-Roles" icon="user-plus">
    Automatically assign roles when members join.
  </Card>

  <Card title="DM Welcome" icon="envelope">
    Send a private welcome message via DM.
  </Card>

  <Card title="Booster Messages" icon="rocket">
    Separate system for thanking server boosters.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Pings not sending">
    * Verify ping on join is enabled in `/welcome setup`
    * Check that the channel still exists
    * Ensure Veronica has Send Messages permission
  </Accordion>

  <Accordion title="Pings not deleting">
    * Verify Veronica has Manage Messages permission
    * Check that the message isn't being deleted by another bot
  </Accordion>

  <Accordion title="Members not receiving notifications">
    * Ensure members have notifications enabled for the server
    * Check that members haven't muted the welcome channel
    * Verify the ping is actually mentioning the user
  </Accordion>
</AccordionGroup>

## Privacy Considerations

<Warning>
  Ping on Join publicly mentions new members. Some users may prefer not to be pinged. Consider:

  * Making the feature opt-in via a reaction role
  * Using a private staff channel for join alerts
  * Providing clear information about the ping in your rules
</Warning>

## Advanced Configuration

For more control over welcome features, explore the full Welcome System:

```bash theme={null}
/welcome setup
```

**Available Options:**

* Welcome messages (channel + DM)
* Goodbye messages
* Ping on join
* Auto-roles
* Custom embed formatting

<Tip>
  Use ping on join in combination with a verification system to ensure new members see your rules and verification instructions immediately.
</Tip>