Skip to main content

Guild Mappings

A guild mapping is the core concept in Copycord — it defines a link between a source server and a clone server. Everything Copycord does revolves around these mappings.

Creating a mapping​

  1. Navigate to the Guilds page in the dashboard
  2. Click Create Mapping
  3. Select the Source Server — the server your user account has access to
  4. Select the Clone Server — the server where your bot is installed
  5. Click Create

Once created, Copycord will immediately begin syncing the structure (channels, categories, roles) from the source to the clone.

Managing mappings​

Pause / Resume​

You can temporarily pause a mapping without deleting it. Paused mappings stop all syncing — no messages, edits, deletes, or structure changes will be forwarded.

Click the toggle button next to a mapping to pause or resume it.

Edit settings​

Each mapping has its own set of cloning options that control what gets synced. Click on a mapping to view and edit its settings. Settings are organized into sections:

  • General — master cloning toggle, message cloning, webhooks
  • Channels — channel deletion, renaming, repositioning, permissions
  • Messages — message editing, deletion, resending
  • Roles — role cloning, deletion, permissions, icons
  • Assets — emoji, stickers, voice/stage channels
  • Server Identity — server icon, banner, splash, description

Message features​

Click Optional Message Features at the bottom of the mapping settings to customize how cloned messages appear:

  • Tag Replies — prepend a link when a message is a reply
  • Anonymize Users — replace usernames with random identities
  • Disable @everyone — strip @everyone and @here pings
  • Disable Role Mentions — strip role mention pings
  • Append Timestamp — show the original message timestamp
  • Append Author — show the original author's name

A live preview shows how the combined settings affect the cloned message.

Delete a mapping​

Deleting a mapping removes the link between the source and clone servers. It does not delete any channels, roles, or messages that were already created in the clone server.

Multiple mappings​

Copycord supports multiple guild mappings simultaneously. You can:

  • Clone several source servers into one clone server
  • Clone one source server into multiple clone servers
  • Any combination of source → clone pairs

Each mapping operates independently with its own filters and settings.

How syncing works​

When a mapping is active, Copycord continuously:

  1. Watches the source server for changes (via the client self-bot)
  2. Forwards new messages to the clone via webhooks
  3. Syncs structural changes (new channels, renames, deletions)
  4. Updates roles, emojis, and stickers as they change
  5. Tracks message edits and deletes

The sync interval for structure checks defaults to every 60 minutes, but individual changes (new channels, renames) are detected and applied in real time via Discord gateway events.