diff --git a/packages/types/src/discord/components.ts b/packages/types/src/discord/components.ts
index 8884e8265..3e23113db 100644
--- a/packages/types/src/discord/components.ts
+++ b/packages/types/src/discord/components.ts
@@ -118,6 +118,8 @@ export interface DiscordButtonComponent extends DiscordBaseComponent {
    *
    * @remarks
    * Buttons of style {@link ButtonStyles.Link | Link} must have an url, any other button with a different style can not have an url
+   *
+   * Maximum 512 characters.
    */
   url?: string
   /** Whether or not this button is disabled */
diff --git a/packages/types/src/discordeno.ts b/packages/types/src/discordeno.ts
index c109ba272..766c49019 100644
--- a/packages/types/src/discordeno.ts
+++ b/packages/types/src/discordeno.ts
@@ -178,7 +178,14 @@ export interface ButtonComponent extends BaseComponent {
   }
   /** Identifier for a purchasable SKU, only available when using premium-style buttons */
   skuId?: BigString
-  /** optional url for link-style buttons that can navigate a user to the web. Only type 5 Link buttons can have a url */
+  /**
+   * optional url for link-style buttons that can navigate a user to the web.
+   * 
+   * @remarks
+   * Only {@link ButtonStyles.Link | Link} buttons can have a url.
+   *
+   * Maximum 512 characters.
+   */
   url?: string
   /** Whether or not this button is disabled */
   disabled?: boolean