Skip to Content
ChannelsDiscord

Discord

Connect a Discord channel to Structura and each published post appears there as a rich embed. Useful for community announcements, development-log channels, or a personal server where you track output.

What gets posted

A single Discord message per publish, formatted as a rich embed:

  • Post title as the embed title, linking to the article.
  • Summary from the post’s excerpt or first paragraph.
  • Featured image as the embed image (when available).
  • Site name as the embed footer.

The bot name and avatar are whatever you configured when you created the Discord webhook.

What you need

A Discord webhook URL for the channel you want to post to. If you’ve set up a Discord webhook before, skip straight to Connect.

Create a Discord webhook

Do this in Discord, once, before coming back to Structura:

  1. Open the Discord server you want posts to land in. You need Manage Webhooks permission on the channel.
  2. Right-click the channel → Edit Channel → Integrations → Webhooks → New Webhook.
  3. Give it a name (e.g., “Structura”) and optionally a custom avatar.
  4. Click Copy Webhook URL. It looks like https://discord.com/api/webhooks/<id>/<token>.
  5. Save/close the webhook settings.

If you don’t have Manage Webhooks permission, a server admin will have to create it for you.

Connect

  1. In wp-admin, go to Structura → Channels.
  2. Click the Discord card. The install panel opens.
  3. Paste the webhook URL into the Webhook URL field.
  4. Click Connect.

Structura posts a small “Structura connected” test embed to the webhook. If it lands in the Discord channel, the install panel shows Connected.

What can go wrong

  • Webhook URL rejected. Discord returns an error for deleted webhooks. Confirm the URL is the full one, including the token segment at the end.
  • Connected but nothing arrives. A server admin may have deleted or regenerated the webhook. Check Structura → System Logs, filter CHANNELS., and look for the Discord error.
  • Embed looks wrong. Discord has per-embed limits (title 256 chars, description 4096 chars, fields count, etc.). Structura truncates to stay under the limits but if something odd surfaces, let us know.

See A channel shows “failed” for the full error playbook.

Rotating the webhook

If the webhook is compromised or you need to redirect to a different channel:

  1. In Discord’s webhook settings, delete the current webhook (or create a new one for the destination channel).
  2. In Structura’s Discord install panel, click Reconnect (or disconnect then connect), and paste the new URL.
Last updated on
Disconnecting or reconnectingEmail to owner