Understanding Toast Notifications and What They Tell You
What it is
A toast notification (sometimes just called a "toast") is a small pop-up card that appears briefly in the corner of the screen to give you instant feedback about something that just happened. It is called a "toast" because it pops up like a slice of bread from a toaster. Toasts in RAPTIX appear at the top-right corner of the screen, stack if multiple arrive together, and go away on their own after a few seconds — you do not have to do anything unless you want to read one more carefully or dismiss it early.
Toasts are used throughout every module of the platform to confirm actions, warn you of a problem, share information, or alert you to a change in network status.
Why it's useful / Key benefits
- Instant, non-blocking feedback. You always know whether an action succeeded or failed, without the platform interrupting your work with a modal dialog you have to close.
- No silent failures. If something goes wrong — a save fails, a file cannot be uploaded, a session issue arises — a toast tells you immediately and clearly, in plain language.
- Colour-coded at a glance. The background colour tells you immediately whether news is good (green), cautionary (yellow), needs attention (red), or informational (blue), before you even read the words.
- Self-dismissing. Toasts disappear automatically so they never pile up and clutter your screen. You can also dismiss one manually with the close button if you want it gone sooner.
- Network awareness. The platform tells you instantly when your internet connection drops or returns, so you are never left wondering why a page stopped responding.
Before you start
- Toast notifications appear automatically — there is nothing to enable or configure. Every user sees them.
- Toasts appear at the top-right corner of the screen on desktop and at the bottom of the screen on some mobile contexts. They do not move or block the navigation bar.
- If several toasts arrive at the same time, they stack vertically.
How to use it — step by step
Toast notifications are fully automatic — the platform shows them when relevant. Here is how to interact with them:
-
Read the message. When a toast appears, glance at the colour and then read the short message to understand what happened.
-
Wait for it to disappear. Most toasts dismiss themselves automatically:
- Success toasts disappear after approximately 5 seconds.
- Error and warning toasts from the engine area stay for up to 8–12 seconds to give you more time to read a detailed message.
- Network status toasts (offline/online) appear and disappear as your connection changes.
-
Dismiss it early. If you have read the toast and do not need it any longer, click the ✕ (close) button on the right side of the toast card to remove it immediately.
-
Act on the message if needed. Some toasts indicate a problem (red or yellow) that you should respond to. Read the message, then take the appropriate action — for example, retry an upload, refresh the page, or contact your administrator.
Options & settings explained
Toast colours and what they mean
| Colour | Icon | Meaning | Common examples |
|---|---|---|---|
| Green | ✅ | Success — An action completed successfully. | File uploaded, workflow saved, task submitted, settings updated. |
| Red | ❌ | Error — Something went wrong and the action did not complete. | Upload failed, connection error, permission denied, save failed. |
| Yellow / Amber | ⚠️ | Warning — The action completed but there is something to be aware of, or a condition needs attention. | Your internet connection is offline, a feature is temporarily unavailable, a limit has been reached. |
| Blue | ℹ️ | Information — A neutral status update or confirmation that does not require any action. | A background process started, a session was renewed, a download is ready. |
Special network toasts
Two specific toasts are managed by the platform-level network monitor and appear regardless of which page you are on:
| Toast | Colour | What it means |
|---|---|---|
| "You are offline" | Yellow | Your device has lost its internet connection. The platform cannot reach the server. Actions like submitting forms or uploading files will fail until connectivity is restored. |
| "Back online" | Green | Your internet connection has been restored. The platform is reconnected and you can resume normal work. |
These toasts appear automatically whenever your connection state changes — you do not trigger them by doing anything.
Anatomy of a toast card
┌─────────────────────────────────────────────┐
│ [icon] Short message text [✕] │
└─────────────────────────────────────────────┘
| Element | Description |
|---|---|
| Coloured background | Instantly communicates success / error / warning / information. |
| Icon | Emoji that reinforces the message type: ✅ ❌ ⚠️ ℹ️ |
| Message text | A short, plain-language description of what happened or what the status is. |
| Close button (✕) | Click to dismiss the toast immediately before its timer expires. |
Auto-dismiss timing
| Toast type | Auto-dismiss time |
|---|---|
| Success (general) | ~5 seconds |
| Error / warning (engine dashboard and download operations) | 8–12 seconds |
| Network status toasts | ~3 seconds |
| Information | ~5 seconds |
Tips & best practices
- Glance at the colour first. In a busy moment, just the colour tells you whether you need to stop and read or can continue working.
- Do not dismiss error toasts immediately. Red toasts often contain the most important information. Let them stay for their full duration or read carefully before closing.
- If you missed a toast, check what you were doing. Toasts confirm or report on the action you just took. If your last action was saving a workflow, and you saw a red toast, the save most likely failed — try again.
- Yellow "offline" toasts are not errors. They indicate a temporary network issue. Once the green "back online" toast appears, your connection is restored and you can retry any failed action.
- Multiple toasts stack. If several actions complete rapidly, you may see a stack of 2–3 toast cards. Each one is independent and has its own timer and close button.
Frequently asked questions
Q: I saw a red toast but it disappeared before I could read it fully. What should I do? Try repeating the action that triggered it. If the error recurs, the toast will appear again and you can read it. If the error only happened once, the action may now succeed without issue. If you continue to see an error you cannot understand, contact your administrator and describe what you were doing when the red toast appeared.
Q: Can I turn toasts off? No — toast notifications are a core feedback mechanism of the platform and cannot be disabled. They are intentionally brief and non-blocking, so they should not interfere with your work.
Q: The platform shows a red toast saying something about a permission. What does that mean? A red toast about a permission indicates your account does not have the rights needed to complete that specific action. Contact your administrator and explain which action you tried to perform. They can review your role and permissions.
Q: I got a yellow "offline" toast but my internet seems fine. Occasionally a momentary blip in the network connection is detected even when your broader internet is stable. Wait a few seconds — if a green "back online" toast follows quickly, everything is normal and no data was lost.
Q: Are toasts logged anywhere so I can review them later? Toast messages are not stored in a history log visible to users. For persisted actions and events in specific modules, authorised users can use the dedicated logs and operational records. See Documents audit logs and Workflow Database.
Q: Why does my toast look different from a colleague's on the same page? Toasts are triggered by the action you just performed or the event that occurred on your session. Two users on the same page may see different toasts because they are performing different actions or experiencing different results.