Skip to main content

Automatic Advertisements

This feature allows you to have CharlesBot automatically post some of your custom commands at a specified interval. This is useful for reminding your chatroom about special deals or events that may be happening in your room.

Automatically Post A Command​

!addad [command] [expiration]

This adds one of your custom commands to list of things to be automatically posted at the interval you set.

The expiration is optional. If you leave it off, the ad stays active until you remove it with !delad. If you run !addad again for the same command, CharlesBot will update the expiration in place. Running !addad !videos with no expiration will also clear any previous expiration and make the ad indefinite again.

Supported expiration formats:

  • Relative durations: 30:00, 30m, 12h, 7d, 2w
  • Dates in MM/DD/YYYY format: 04/30/2026, 4/30/2026, 4/30/26
  • Dates with dashes are also supported: 4-30-2026, 4-30-26
  • ISO date: 2026-04-30

Date-only expirations are resolved to the end of that day in CharlesBot's Pacific timezone. Two-digit years are treated as 20YY, so 4/30/26 becomes April 30, 2026.

If you need an exact clock time, CharlesBot also accepts MM/DD/YYYY h:mm A and YYYY-MM-DD HH:mm. Any time you include is interpreted in Pacific time, and CharlesBot will echo back the exact resolved expiration after you set it.

Example

!addad !videos

This will tell CharlesBot to start automatically posting the !videos command (that you created from the storing a new command example) at whatever interval you set, with no expiration.

!addad !videos 7d

This will tell CharlesBot to keep posting the !videos command for the next 7 days.

!addad !videos 04/30/2026

This will tell CharlesBot to keep posting the !videos command until the end of April 30, 2026 in Pacific time.

Stop Automatically Posting A Command​

!delad [command]

This removes one of your custom commands from the advertisement list.

Example

!delad !videos

This will remove the !videos command from the list of advertisements.

List Commands On The Advertisement List​

!listads

This will output the list of the commands currently on the ad list. If an ad has an expiration, CharlesBot will show the resolved expiration next to it.

Setting an Interval​

!setinterval [interval]

This command controls how often CharlesBot will post a command from the ad list. Set it to 0 to stop posting advertisements completely.

Supported interval formats:

  • Seconds: 180, 300
  • Timer-style durations: 5:00
  • Unit suffixes: 5m, 2h
Example

!setinterval 180

This will have CharlesBot post a command from your ad list every 180 seconds (3 minutes).

!setinterval 5m

This will have CharlesBot post a command from your ad list every 5 minutes.