| WidgetNote does not appear in the widget picker | The app has not been opened since installing, or the phone has not re-indexed widgets | Open WidgetNote once, then go back to the Home Screen and try again. A restart forces the widget list to rebuild. |
| The widget is added but shows placeholder or empty text | No note has been selected for that particular widget yet | Long-press the widget, choose Edit Widget, and pick which note it should display. |
| The widget shows the wrong note | Each widget stores its own note choice, so a second widget defaults independently | Long-press that widget, tap Edit Widget, and select the right note. Other widgets keep their own selection. |
| Edits are not showing up on the widget | iOS controls widget refresh timing and can delay an update | Tap the widget to open the app, which normally brings it current. If it keeps lagging, enable Background App Refresh for WidgetNote in Settings. |
| A shared note is not updating for the other person | iCloud is signed out on one device, or that person has not accepted the share yet | Check that both devices are signed into iCloud with iCloud Drive on, and confirm the invite was accepted. |
| The text is cut off | The note is longer than the widget size can display | Move to a larger widget size, shorten the note, or split it across two widgets. |