Troubleshooting
When something isn't working in your Portals space, this section will help you diagnose and fix the problem.
How to Use This Section
- Identify the symptom - What isn't working?
- Find the relevant guide - Each page covers a specific category of issues
- Follow the diagnostic steps - Work through the checklist to find the cause
- Apply the fix - Each issue includes the solution
Common Issue Categories
| Issue Type | Go To |
|---|---|
| Function Effect not executing | Function Effect Errors |
| Task stuck or won't change state | Task State Issues |
| Iframe not loading or communicating | Iframe Debugging |
| Quick answers to frequent problems | Common Gotchas |
Before You Start
When something does not behave as expected, start with these checks:
- Browser Console - Press F12 to open developer tools. Check the Console tab for JavaScript errors (useful for iframes).
- Variable Manager - View and reset variable values in Space Options > Variable Manager.
Still Stuck?
If you've worked through the relevant troubleshooting guide and still can't fix the issue:
- Check the Portals Discord for community help
- Search existing discussions - your issue may have been solved before
- Post a detailed description including:
- What you're trying to do
- What's happening instead
- Steps you've already tried