Customizing Notifications

Promptless sends notifications to your team when documentation suggestions are ready for review. You can configure notification channels in your organization’s promptless.yaml file using the policies section.

Notification Channel Configuration

Set the default notification channel and create trigger-specific overrides in your Configuration page:

policies:
  default:
    notification:
      slack_channel: docs-updates

  rules:
    - if:
        doc_collection: acme/internal-docs
      then:
        notification:
          slack_channel: internal-docs-team

Channel names don’t need the # prefix. When Slack channels are renamed, Promptless automatically updates your configuration.

See the Configuration Reference for the complete policies schema.

Notification Preferences File

Notification preferences are stored in the doc_workflow/notification_preferences.md file within your Agent Knowledge Base. This file is a lightweight scaffold where you add overrides and customizations—Promptless handles the underlying templates and message formatting automatically.

Note

If your organization previously used a notification_skill.md file, Promptless automatically migrates it to the new notification_preferences.md format. Your customizations are preserved during migration.

What You Can Customize

The preferences file lets you override:

• When to notify: Control which events trigger notifications and when to skip them
• Delivery channels: Set preferences for Slack vs. GitHub notifications
• Message style: Adjust the tone and context included in notification messages

Example Customizations

Here are some common ways teams customize their notifications:

Change notification timing:

Only send notifications for suggestions that modify more than one file.
Skip notifications for automated triggers that don't yield documentation updates.

Adjust delivery preferences:

Always reply in the originating Slack thread when the trigger came from Slack.
Use GitHub comments when reviewers are already engaged with the source PR.

Customize message style:

Use a casual, friendly tone in all notification messages.
Include enough context that someone new to the thread can understand why Promptless is posting.

Slack Notification Features

When you have the Slack integration connected, Promptless sends rich notifications with:

• Interactive buttons: Quickly publish suggestions or open PRs for review directly from Slack
• Diff file attachments: See the full diff of documentation changes in a thread reply
• Channel support: Receive notifications in specific channels by name, not just by ID

Tip

Promptless automatically detects protected branches in your documentation repository. When detected, Slack notifications show “Create PR” or “View PR” buttons instead of “Publish” to prevent merge errors.

Getting Help

Need help configuring your notification preferences? Contact us at help@gopromptless.ai and we’ll help you set up the customizations that work best for your team.