{"id":14721,"library":"netlify-plugin-discord","title":"Netlify Discord Notifications","description":"netlify-plugin-discord is a Netlify Build plugin designed to send automated build notifications to a Discord channel via webhooks. As of its initial release (v0.0.2), it offers a straightforward way to keep development teams informed about build statuses (success, failure, etc.) directly within Discord. Its release cadence is currently unknown given its early stage. The plugin differentiates itself by providing a simple, opinionated integration specifically for Netlify's build ecosystem, contrasting with more generic webhook solutions or custom scripting that would require more setup. It focuses solely on Discord notifications, making it a targeted utility for Netlify users who utilize Discord for team communication.","status":"active","version":"0.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/kellymears/netlify-plugin-discord","tags":["javascript","netlify-plugin","netlify","discord"],"install":[{"cmd":"npm install netlify-plugin-discord","lang":"bash","label":"npm"},{"cmd":"yarn add netlify-plugin-discord","lang":"bash","label":"yarn"},{"cmd":"pnpm add netlify-plugin-discord","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[],"quickstart":{"code":"{\n  \"netlify.toml\": \"\"\"\n[[plugins]]\n  package = \"netlify-plugin-discord\"\n\n[build]\n  # Example build settings\n  command = \"npm run build\"\n  publish = \"dist\"\n\"\"\",\n  \"environment_variable\": \"DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN\"\n}","lang":"toml","description":"This quickstart configures the netlify-plugin-discord in your netlify.toml and sets the required Discord webhook URL as an environment variable, enabling build notifications."},"warnings":[{"fix":"Ensure DISCORD_WEBHOOK_URL is configured in your Netlify site settings under 'Build & deploy' -> 'Environment variables' with a valid Discord webhook URL.","message":"The plugin requires the DISCORD_WEBHOOK_URL environment variable to be correctly set in Netlify. Without it, notifications will not be sent, and the plugin may fail silently or with a generic error during the build process.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Always use Netlify's environment variable management for DISCORD_WEBHOOK_URL. Do not hardcode it in netlify.toml or any source files.","message":"Discord webhook URLs are sensitive. Ensure they are stored securely as environment variables and not committed directly into your repository. Public exposure of webhooks can lead to abuse.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Monitor the plugin's GitHub repository for updates and release notes, especially before upgrading to new major versions.","message":"As an early-stage plugin (v0.0.2), its long-term maintenance and future breaking changes are not yet established. Be prepared for potential changes in configuration or behavior in future major releases.","severity":"gotcha","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Verify the DISCORD_WEBHOOK_URL in Netlify's environment variables. Test the webhook URL directly (e.g., using `curl -H \"Content-Type: application/json\" -d '{\"content\": \"Test message\"}' YOUR_WEBHOOK_URL`) and ensure the Discord channel allows messages from webhooks.","cause":"DISCORD_WEBHOOK_URL is either missing, incorrect, or the Discord channel permissions are misconfigured.","error":"Discord notifications not appearing in channel."},{"fix":"Check Netlify build logs for more specific error messages. Ensure the `DISCORD_WEBHOOK_URL` is correct and accessible. Temporarily disable the plugin to confirm it's the source of the build failure.","cause":"Could be an internal plugin error, an invalid webhook URL causing a fetch error, or network issues.","error":"Build fails with 'Plugin \"netlify-plugin-discord\" failed' or similar generic error."}],"ecosystem":"npm"}