Help Center

Every announcement you publish represents your brand. Userorbit gives you several design options to make your announcements visually appealing and actionable. This guide covers cover images, CTA buttons, description metadata, formatting, and previewing before you publish.

Adding a cover image

A cover image is the banner displayed at the top of your announcement. It is the first thing users see in the changelog, widget feed, and email broadcasts, so it is worth getting right.

To add a cover image:

1. Open the announcement editor.
2. Click the Cover image area at the top of the editor or use the cover image option in the sidebar.
3. Upload an image or paste a URL. Userorbit accepts PNG, JPG, GIF, and WebP formats.
4. The image will be displayed at full width, so use a landscape aspect ratio — 1200×630 pixels works well for most layouts.

Tips for effective cover images:

• Use screenshots of the actual feature when announcing product updates.
• Keep text on images minimal — the title and body already provide context.
• Maintain a consistent visual style across announcements so your changelog looks cohesive.

Configuring CTA buttons

Call-to-action buttons drive users from your announcement to a specific destination, like a feature page, signup form, or documentation article. Each announcement supports a CTA with three configurable properties:

• Button title — The text displayed on the button, such as "Try it now" or "Learn more."
• Link URL — The destination URL users navigate to when they click the button.
• Button image — An optional icon displayed alongside the button text for additional visual context.

To add a CTA:

1. In the announcement editor sidebar, locate the Call to action section.
2. Enter a title for the button. Keep it short and action-oriented.
3. Paste the destination URL.
4. Optionally upload or link a small icon image.

CTA buttons appear prominently in the announcement body, the widget feed, and email broadcasts. Use them to convert attention into engagement.

Setting description metadata

The description field is a short summary that appears in previews — search results, social shares, and the condensed widget feed view. It is separate from the full announcement body.

To set the description:

1. In the sidebar, find the Description or meta field.
2. Write a one- or two-sentence summary of the announcement. Aim for 120–160 characters.
3. Focus on the user benefit, not the technical details.

If you leave the description empty, Userorbit generates a preview from the first few lines of your body content.

Formatting your content

The announcement editor supports rich formatting to help you structure content clearly:

• Headings (H2, H3) — Break long announcements into scannable sections.
• Bold and italic — Emphasize key points without overdoing it.
• Bullet and numbered lists — Present steps or feature lists clearly.
• Code blocks — Show API changes, configuration snippets, or technical details.
• Images and video embeds — Add inline visuals to illustrate your points.
• Links — Reference documentation, related announcements, or external resources.

Previewing before publishing

Always preview your announcement before publishing. Userorbit lets you see exactly how it will appear in the changelog and widget. In the editor, click the Preview button to open a rendered view. Check for:

• Image sizing and cropping.
• CTA button visibility and link correctness.
• Overall readability on both desktop and mobile layouts.
• Formatting consistency with your other published announcements.

Make adjustments as needed, then publish when you are satisfied with the result.