Class Guild

Represents a Discord server.

Hierarchy (view full)

Constructors

constructor

Properties

afkChannel? afkChannelID afkTimeout application? applicationID approximateMemberCount? approximatePresenceCount? auditLogEntries autoModerationRules banner channels client defaultMessageNotifications description discoverySplash emojis explicitContentFilter features icon id incidentActions integrations inventorySettings invites joinedAt large latestOnboardingQuestionID maxMembers? maxPresences? maxStageVideoChannelUsers? maxVideoChannelUsers? memberCount members mfaLevel name nsfwLevel owner? ownerID preferredLocale premiumProgressBarEnabled premiumSubscriptionCount? premiumTier publicUpdatesChannel? publicUpdatesChannelID region? roles rulesChannel? rulesChannelID safetyAlertsChannel? safetyAlertsChannelID scheduledEvents splash stageInstances stickers systemChannel? systemChannelFlags systemChannelID threads unavailable vanityURLCode verificationLevel voiceStates welcomeScreen? widgetChannel? widgetChannelID widgetEnabled?

Accessors

clientMember createdAt shard voiceAdapterCreator

Methods

addMember addMemberRole bannerURL beginPrune bulkBan createAutoModerationRule createBan createChannel createEmoji createRole createScheduledEvent createSticker createTemplate createTestEntitlement delete deleteAutoModerationRule deleteEmoji deleteIntegration deleteRole deleteScheduledEvent deleteSticker deleteTemplate disableCommunity disableDiscovery disableInvites disableRaidAlerts discoverySplashURL edit editAutoModerationRule editChannelPositions editCurrentMember editCurrentUserVoiceState editEmoji editIncidentActions editMFALevel editMember editOnboarding editRole editRolePositions editScheduledEvent editSticker editTemplate editUserVoiceState editWelcomeScreen editWidget enableCommunity enableDiscovery enableInvites enableRaidAlerts fetchMembers getActiveThreads getAuditLog getAutoModerationRule getAutoModerationRules getBan getBans getChannels getEmoji getEmojis getEntitlements getIntegrations getInvites getMember getMembers getOnboarding getPreview getPruneCount getRole getRoles getScheduledEvent getScheduledEventUsers getScheduledEvents getSticker getStickers getTemplates getVanityURL getVoiceRegions getVoiceState getWebhooks getWelcomeScreen getWidget getWidgetImage getWidgetJSON getWidgetSettings iconURL joinChannel leave leaveChannel memberSearch permissionsOf removeBan removeMember removeMemberRole searchMembers splashURL syncTemplate toJSON toString generateID getCreatedAt getDiscordEpoch

Constructors

constructor

Properties

Optional afkChannel

afkChannel?: null | VoiceChannel

This guild's afk voice channel.

afkChannelID

afkChannelID: null | string

The ID of this guild's afk voice channel.

afkTimeout

afkTimeout: number

The seconds after which voice users will be moved to the afk channel.

Optional application

application?: null | ClientApplication

The application that created this guild, if applicable.

applicationID

applicationID: null | string

The ID of the application that created this guild, if applicable.

Optional approximateMemberCount

approximateMemberCount?: number

The approximate number of members in this guild (if retrieved with counts).

Optional approximatePresenceCount

approximatePresenceCount?: number

The approximate number of non-offline members in this guild (if retrieved with counts).

auditLogEntries

auditLogEntries: TypedCollection<RawAuditLogEntry, AuditLogEntry, []>

The cached audit log entries. This requires both the GUILD_MODERATION intent, as well as the VIEW_AUDIT_LOG permission.

autoModerationRules

autoModerationRules: TypedCollection<RawAutoModerationRule, AutoModerationRule, []>

The auto moderation rules in this guild.

banner

banner: null | string

The hash of this guild's banner.

channels

channels: TypedCollection<RawGuildChannel, AnyGuildChannelWithoutThreads, []>

The channels in this guild.

client

client: Client<ClientEvents>

defaultMessageNotifications

defaultMessageNotifications: DefaultMessageNotificationLevels

The default message notifications level of this guild.

description

description: null | string

The description of this guild.

discoverySplash

discoverySplash: null | string

The discovery splash of this guild. Only present if the guild has the DISCOVERABLE feature.

emojis

emojis: SimpleCollection<string, RawGuildEmoji, GuildEmoji, "id">

The custom emojis of this guild.

explicitContentFilter

explicitContentFilter: ExplicitContentFilterLevels

The explicit content filter of this guild.

features

features: ("ACTIVITIES_ALPHA" | "ACTIVITIES_EMPLOYEE" | "ACTIVITIES_INTERNAL_DEV" | "ANIMATED_BANNER" | "ANIMATED_ICON" | "APPLICATION_COMMAND_PERMISSIONS_V2" | "AUTO_MODERATION" | "AUTOMOD_TRIGGER_USER_PROFILE" | "BANNER" | "BOT_DEVELOPER_EARLY_ACCESS" | "BURST_REACTIONS" | "CHANNEL_HIGHLIGHTS_DISABLED" | "CHANNEL_HIGHLIGHTS" | "CHANNEL_ICON_EMOJIS_GENERATED" | "CLYDE_DISABLED" | "CLYDE_ENABLED" | "CLYDE_EXPERIMENT_ENABLED" | "COMMERCE" | "COMMUNITY_CANARY" | "COMMUNITY_EXP_LARGE_GATED" | "COMMUNITY_EXP_LARGE_UNGATED" | "COMMUNITY_EXP_MEDIUM" | "COMMUNITY" | "CREATOR_ACCEPTED_NEW_TERMS" | "CREATOR_MONETIZABLE_DISABLED" | "CREATOR_MONETIZABLE_PENDING_NEW_OWNER_ONBOARDING" | "CREATOR_MONETIZABLE_PROVISIONAL" | "CREATOR_MONETIZABLE_RESTRICTED" | "CREATOR_MONETIZABLE_WHITEGLOVE" | "CREATOR_MONETIZABLE" | "CREATOR_STORE_PAGE" | "DEVELOPER_SUPPORT_SERVER" | "DISCOVERABLE_DISABLED" | "DISCOVERABLE" | "ENABLED_DISCOVERABLE_BEFORE" | "ENABLED_MODERATION_EXPERIENCE_FOR_NON_COMMUNITY" | "EXPOSED_TO_ACTIVITIES_WTP_EXPERIMENT" | "FEATURABLE" | "GUESTS_ENABLED" | "GUILD_HOME_DEPRECATION_OVERRIDE" | "GUILD_HOME_OVERRIDE" | "GUILD_HOME_TEST" | "GUILD_ONBOARDING_EVER_ENABLED" | "GUILD_ONBOARDING_HAS_PROMPTS" | "GUILD_ONBOARDING" | "GUILD_ROLE_SUBSCRIPTION_TIER_TEMPLATE" | "GUILD_SERVER_GUIDE" | "GUILD_WEB_PAGE_VANITY_URL" | "HAD_EARLY_ACTIVITIES_ACCESS" | "HAS_DIRECTORY_ENTRY" | "HUB" | "INCREASED_THREAD_LIMIT" | "INTERNAL_EMPLOYEE_ONLY" | "INVITE_SPLASH" | "INVITES_DISABLED" | "LINKED_TO_HUB" | "MARKETPLACES_CONNECTION_ROLES" | "MEMBER_PROFILES" | "MEMBER_SAFETY_PAGE_ROLLOUT" | "MEMBER_VERIFICATION_GATE_ENABLED" | "MONETIZATION_ENABLED" | "MORE_EMOJI" | "MORE_EMOJIS" | "MORE_STICKERS" | "NEW_THREAD_PERMISSIONS" | "NEWS" | "NON_COMMUNITY_RAID_ALERTS" | "PARTNERED" | "PREVIEW_ENABLED" | "PREVIOUSLY_DISCOVERABLE" | "PRIVATE_THREADS" | "PRODUCTS_AVAILABLE_FOR_PURCHASE" | "RAID_ALERTS_DISABLED" | "RAID_ALERTS_ENABLED" | "ROLE_ICONS" | "ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE" | "ROLE_SUBSCRIPTIONS_ENABLED" | "SEVEN_DAY_THREAD_ARCHIVE" | "SHARD" | "SOUNDBOARD" | "SUMMARIES_DISABLED_BY_USER" | "SUMMARIES_ENABLED_BY_USER" | "SUMMARIES_ENABLED_GA" | "SUMMARIES_ENABLED" | "SUMMARIES_OPT_OUT_EXPERIENCE" | "SUMMARIES_PAUSED" | "TEXT_IN_STAGE_ENABLED" | "TEXT_IN_VOICE_ENABLED" | "THREADS_ENABLED_TESTING" | "THREADS_ENABLED" | "THREE_DAY_THREAD_ARCHIVE" | "TICKETED_EVENTS_ENABLED" | "VANITY_URL" | "VERIFIED" | "VIP_REGIONS" | "VOICE_IN_THREADS" | "WELCOME_SCREEN_ENABLED")[]

The features this guild has.

icon

icon: null | string

The icon hash of this guild.

id

id: string

incidentActions

incidentActions: null | IncidentActions

integrations

integrations: TypedCollection<RawIntegration, Integration, [guildID?: string]>

The integrations in this guild.

inventorySettings

inventorySettings: null | InventorySettings

The guild's inventory settings.

invites

invites: SimpleCollection<string, RawInvite, Invite<"withMetadata", AnyInviteChannel | Uncached>, "code">

The cached invites in this guild. This will only be populated by invites created while the client is active.

joinedAt

joinedAt: null | Date

The date at which this guild was joined.

large

large: boolean

If this guild is considered large.

latestOnboardingQuestionID

latestOnboardingQuestionID: null | string

Optional maxMembers

maxMembers?: number

The maximum amount of members this guild can have.

Optional maxPresences

maxPresences?: number

The maximum amount of people that can be present at a time in this guild. Only present for very large guilds.

Optional maxStageVideoChannelUsers

maxStageVideoChannelUsers?: number

The maximum amount of users that can be present in a stage video channel.

Optional maxVideoChannelUsers

maxVideoChannelUsers?: number

The maximum amount of users that can be present in a video channel.

memberCount

memberCount: number

The number of members in this guild.

members

members: TypedCollection<RawMember | RESTMember, Member, [guildID: string]>

The cached members in this guild.

mfaLevel

mfaLevel: MFALevels

The required mfa level for moderators of this guild.

name

name: string

The name of this guild.

nsfwLevel

nsfwLevel: GuildNSFWLevels

The nsfw level of this guild.

Optional owner

owner?: null | User

The owner of this guild.

ownerID

ownerID: null | string

The ID of the owner of this guild.

preferredLocale

preferredLocale: string

The preferred locale of this guild.

premiumProgressBarEnabled

premiumProgressBarEnabled: boolean

If this guild has the boost progress bar enabled.

Optional premiumSubscriptionCount

premiumSubscriptionCount?: number

The number of nitro boosts this guild has.

premiumTier

premiumTier: PremiumTiers

The boost level of this guild.

Optional publicUpdatesChannel

publicUpdatesChannel?: null | AnyTextableGuildChannel

The channel where notices from Discord are received. Only present in guilds with the COMMUNITY feature.

publicUpdatesChannelID

publicUpdatesChannelID: null | string

The id of the channel where notices from Discord are received. Only present in guilds with the COMMUNITY feature.

Optional region

region?: null | string

Deprecated

The region of this guild.

roles

roles: TypedCollection<RawRole, Role, [guildID: string]>

The roles in this guild.

Optional rulesChannel

rulesChannel?: null | TextChannel

The channel where rules/guidelines are displayed. Only present in guilds with the COMMUNITY feature.

rulesChannelID

rulesChannelID: null | string

The id of the channel where rules/guidelines are displayed. Only present in guilds with the COMMUNITY feature.

Optional safetyAlertsChannel

safetyAlertsChannel?: null | TextChannel

The channel where safety related notices are posted.

safetyAlertsChannelID

safetyAlertsChannelID: null | string

The ID if the channel where safety related notices are posted.

scheduledEvents

scheduledEvents: TypedCollection<RawScheduledEvent, GuildScheduledEvent, []>

The scheduled events in this guild.

splash

splash: null | string

The invite splash hash of this guild.

stageInstances

stageInstances: TypedCollection<RawStageInstance, StageInstance, []>

The stage instances in this guild.

stickers

stickers: SimpleCollection<string, RawSticker, Sticker, "id">

The custom stickers of this guild.

Optional systemChannel

systemChannel?: null | TextChannel

The channel where welcome messages and boosts notices are posted.

systemChannelFlags

systemChannelFlags: number

The flags for the system channel.

systemChannelID

systemChannelID: null | string

The ID of the channel where welcome messages and boosts notices are posted.

threads

threads: TypedCollection<RawThreadChannel, AnyThreadChannel, []>

The threads in this guild.

unavailable

unavailable: boolean

If this guild is unavailable.

vanityURLCode

vanityURLCode: null | string

The vanity url of this guild. Only present in guilds with the VANITY_URL feature.

verificationLevel

verificationLevel: VerificationLevels

The verification level of this guild.

voiceStates

voiceStates: TypedCollection<RawVoiceState, VoiceState<AnyVoiceChannel>, []>

The voice states of members in voice channels.

Optional welcomeScreen

welcomeScreen?: WelcomeScreen

The welcome screen configuration. Only present in guilds with the WELCOME_SCREEN_ENABLED feature.

Optional widgetChannel

widgetChannel?: null | TextChannel | VoiceChannel | AnnouncementChannel | StageChannel | ForumChannel | MediaChannel | AnnouncementThreadChannel | PublicThreadChannel | PrivateThreadChannel

The channel the widget will generate an invite to, or null if set to no invite.

widgetChannelID

widgetChannelID: null | string

The id of the channel the widget will generate an invite to, or null if set to no invite.

Optional widgetEnabled

widgetEnabled?: boolean

If the widget is enabled.

Accessors

clientMember

createdAt

shard

voiceAdapterCreator

  • get voiceAdapterCreator(): DiscordGatewayAdapterCreator

  • The voice adapter creator for this guild that can be used with @discordjs/voice to play audio in voice and stage channels.

    Returns DiscordGatewayAdapterCreator

Methods

addMember

  • addMember(userID, options): Promise<void | Member>

  • Add a member to this guild. Requires an access token with the guilds.join scope.

    Returns the newly added member upon success, or void if the member is already in the guild.

    Parameters

    • userID: string

      The ID of the user to add.

    • options: AddMemberOptions

      The options for adding the member.

    Returns Promise<void | Member>

addMemberRole

  • addMemberRole(memberID, roleID, reason?): Promise<void>

  • Add a role to a member.

    Parameters

    • memberID: string

      The ID of the member.

    • roleID: string

      The ID of the role to add.

    • Optional reason: string

      The reason for adding the role.

    Returns Promise<void>

bannerURL

  • bannerURL(format?, size?): null | string

  • The url of this guild's banner.

    Parameters

    • Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"

      The format the url should be.

    • Optional size: number

      The dimensions of the image.

    Returns null | string

beginPrune

bulkBan

createAutoModerationRule

createBan

createChannel

createEmoji

createRole

createScheduledEvent

createSticker

createTemplate

createTestEntitlement

  • createTestEntitlement(skuID, applicationID?): Promise<TestEntitlement>

  • Create a test entitlement for this guild.

    Parameters

    • skuID: string

      The ID of the SKU to create an entitlement for.

    • Optional applicationID: string

      The ID of the application to create the entitlement for. If present, defaults to the logged in client's application id.

    Returns Promise<TestEntitlement>

delete

deleteAutoModerationRule

  • deleteAutoModerationRule(ruleID, reason?): Promise<void>

  • Delete an auto moderation rule in this guild.

    Parameters

    • ruleID: string

      The ID of the rule to delete.

    • Optional reason: string

      The reason for deleting the rule.

    Returns Promise<void>

deleteEmoji

  • deleteEmoji(emojiID, reason?): Promise<void>

  • Delete an emoji in this guild.

    Parameters

    • emojiID: string

      The ID of the emoji.

    • Optional reason: string

      The reason for deleting the emoji.

    Returns Promise<void>

deleteIntegration

  • deleteIntegration(integrationID, reason?): Promise<void>

  • Delete an integration.

    Parameters

    • integrationID: string

      The ID of the integration.

    • Optional reason: string

      The reason for deleting the integration.

    Returns Promise<void>

deleteRole

  • deleteRole(roleID, reason?): Promise<void>

  • Delete a role.

    Parameters

    • roleID: string

      The ID of the role to delete.

    • Optional reason: string

      The reason for deleting the role.

    Returns Promise<void>

deleteScheduledEvent

  • deleteScheduledEvent(eventID, reason?): Promise<void>

  • Delete a scheduled event.

    Parameters

    • eventID: string

      The ID of the scheduled event.

    • Optional reason: string

      The reason for deleting the scheduled event. Discord's docs do not explicitly state a reason can be provided, so it may not be used.

    Returns Promise<void>

deleteSticker

  • deleteSticker(stickerID, reason?): Promise<void>

  • Delete a sticker.

    Parameters

    • stickerID: string

      The ID of the sticker to delete.

    • Optional reason: string

      The reason for deleting the sticker.

    Returns Promise<void>

deleteTemplate

disableCommunity

  • disableCommunity(reason?): Promise<Guild>

  • Disable the COMMUNITY feature for this guild. Requires the Administrator permission.

    Parameters

    • Optional reason: string

      The reason for disable the feature.

    Returns Promise<Guild>

disableDiscovery

  • disableDiscovery(reason?): Promise<Guild>

  • Disable the DISCOVERABLE feature for this guild. Requires the Administrator permission.

    Parameters

    • Optional reason: string

      The reason for disabling the feature.

    Returns Promise<Guild>

disableInvites

  • disableInvites(reason?): Promise<Guild>

  • Disable the INVITES_DISABLED feature for this guild. Requires the Manage Guild permission.

    Parameters

    • Optional reason: string

      The reason for disabling the feature.

    Returns Promise<Guild>

disableRaidAlerts

  • disableRaidAlerts(reason?): Promise<Guild>

  • Disable the RAID_ALERTS_ENABLED feature for this guild. Requires the Manage Guild permission.

    Parameters

    • Optional reason: string

      The reason for disabling the feature.

    Returns Promise<Guild>

discoverySplashURL

  • discoverySplashURL(format?, size?): null | string

  • The url of this guild's discovery splash.

    Parameters

    • Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"

      The format the url should be.

    • Optional size: number

      The dimensions of the image.

    Returns null | string

edit

editAutoModerationRule

editChannelPositions

editCurrentMember

editCurrentUserVoiceState

editEmoji

editIncidentActions

editMFALevel

editMember

  • editMember(memberID, options): Promise<Member>

  • Edit a member of this guild. Use <Guild>.editCurrentMember if you wish to update the nick of this client using the CHANGE_NICKNAME permission.

    Parameters

    • memberID: string

      The ID of the member.

    • options: EditMemberOptions

      The options for editing the member.

    Returns Promise<Member>

editOnboarding

editRole

editRolePositions

editScheduledEvent

editSticker

editTemplate

editUserVoiceState

editWelcomeScreen

editWidget

enableCommunity

enableDiscovery

  • enableDiscovery(reason?): Promise<Guild>

  • Enable the DISCOVERABLE feature for this guild. Requires the Administrator permission. The server must also be passing all discovery requirements.

    Parameters

    • Optional reason: string

      The reason for enabling the feature.

    Returns Promise<Guild>

enableInvites

enableRaidAlerts

  • enableRaidAlerts(reason?): Promise<Guild>

  • Enable the RAID_ALERTS_ENABLED feature for this guild. Requires the Manage Guild permission.

    Parameters

    • Optional reason: string

      The reason for enabling the feature.

    Returns Promise<Guild>

fetchMembers

getActiveThreads

getAuditLog

getAutoModerationRule

getAutoModerationRules

getBan

getBans

getChannels

getEmoji

getEmojis

getEntitlements

getIntegrations

getInvites

getMember

getMembers

getOnboarding

getPreview

getPruneCount

getRole

getRoles

getScheduledEvent

getScheduledEventUsers

getScheduledEvents

getSticker

getStickers

getTemplates

getVanityURL

getVoiceRegions

getVoiceState

getWebhooks

getWelcomeScreen

getWidget

getWidgetImage

getWidgetJSON

getWidgetSettings

iconURL

  • iconURL(format?, size?): null | string

  • The url of this guild's icon.

    Parameters

    • Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"

      The format the url should be.

    • Optional size: number

      The dimensions of the image.

    Returns null | string

joinChannel

leave

leaveChannel

memberSearch

permissionsOf

removeBan

  • removeBan(userID, reason?): Promise<void>

  • Remove a ban.

    Parameters

    • userID: string

      The ID of the user to remove the ban from.

    • Optional reason: string

      The reason for removing the ban.

    Returns Promise<void>

removeMember

  • removeMember(memberID, reason?): Promise<void>

  • Remove a member from this guild.

    Parameters

    • memberID: string

      The ID of the user to remove.

    • Optional reason: string

      The reason for the removal.

    Returns Promise<void>

removeMemberRole

  • removeMemberRole(memberID, roleID, reason?): Promise<void>

  • Remove a role from a member.

    Parameters

    • memberID: string

      The ID of the member.

    • roleID: string

      The ID of the role to remove.

    • Optional reason: string

      The reason for removing the role.

    Returns Promise<void>

searchMembers

splashURL

  • splashURL(format?, size?): null | string

  • The url of this guild's invite splash.

    Parameters

    • Optional format: "jpg" | "jpeg" | "png" | "webp" | "gif"

      The format the url should be.

    • Optional size: number

      The dimensions of the image.

    Returns null | string

syncTemplate

toJSON

toString

Static generateID

Static getCreatedAt

Static getDiscordEpoch

Settings

Member Visibility

Theme

On This Page

constructorafkChannelafkChannelIDafkTimeoutapplicationapplicationIDapproximateMemberCountapproximatePresenceCountauditLogEntriesautoModerationRulesbannerchannelsclientdefaultMessageNotificationsdescriptiondiscoverySplashemojisexplicitContentFilterfeaturesiconidincidentActionsintegrationsinventorySettingsinvitesjoinedAtlargelatestOnboardingQuestionIDmaxMembersmaxPresencesmaxStageVideoChannelUsersmaxVideoChannelUsersmemberCountmembersmfaLevelnamensfwLevelownerownerIDpreferredLocalepremiumProgressBarEnabledpremiumSubscriptionCountpremiumTierpublicUpdatesChannelpublicUpdatesChannelIDregionrolesrulesChannelrulesChannelIDsafetyAlertsChannelsafetyAlertsChannelIDscheduledEventssplashstageInstancesstickerssystemChannelsystemChannelFlagssystemChannelIDthreadsunavailablevanityURLCodeverificationLevelvoiceStateswelcomeScreenwidgetChannelwidgetChannelIDwidgetEnabledclientMembercreatedAtshardvoiceAdapterCreatoraddMemberaddMemberRolebannerURLbeginPrunebulkBancreateAutoModerationRulecreateBancreateChannelcreateEmojicreateRolecreateScheduledEventcreateStickercreateTemplatecreateTestEntitlementdeletedeleteAutoModerationRuledeleteEmojideleteIntegrationdeleteRoledeleteScheduledEventdeleteStickerdeleteTemplatedisableCommunitydisableDiscoverydisableInvitesdisableRaidAlertsdiscoverySplashURLediteditAutoModerationRuleeditChannelPositionseditCurrentMembereditCurrentUserVoiceStateeditEmojieditIncidentActionseditMFALeveleditMembereditOnboardingeditRoleeditRolePositionseditScheduledEventeditStickereditTemplateeditUserVoiceStateeditWelcomeScreeneditWidgetenableCommunityenableDiscoveryenableInvitesenableRaidAlertsfetchMembersgetActiveThreadsgetAuditLoggetAutoModerationRulegetAutoModerationRulesgetBangetBansgetChannelsgetEmojigetEmojisgetEntitlementsgetIntegrationsgetInvitesgetMembergetMembersgetOnboardinggetPreviewgetPruneCountgetRolegetRolesgetScheduledEventgetScheduledEventUsersgetScheduledEventsgetStickergetStickersgetTemplatesgetVanityURLgetVoiceRegionsgetVoiceStategetWebhooksgetWelcomeScreengetWidgetgetWidgetImagegetWidgetJSONgetWidgetSettingsiconURLjoinChannelleaveleaveChannelmemberSearchpermissionsOfremoveBanremoveMemberremoveMemberRolesearchMemberssplashURLsyncTemplatetoJSONtoStringgenerateIDgetCreatedAtgetDiscordEpoch