Troubleshooting: Buttons Greyed Out Unexpectedly

Problem

Action buttons within the Zudello document viewer (e.g., Save, Update, Save and Submit, Approve, Reject) are disabled (greyed out), preventing you from performing the expected action.

Common Causes

1. Permissions Missing: You lack the necessary action permission for that button (e.g., #UPDATE for Save/Update, #SUBMIT for Save and Submit, #APPROVE for Approve/Reject). See User Cannot Perform Actions.
2. Document Status Restrictions: The document's current status does not allow the action.
   • Save/Update: Disabled in non-editable statuses (e.g., APPROVAL (usually), PROCESSING, COMPLETE, CLOSED).
   • Save and Submit: Disabled if the document is not in an editable status (like REVIEW or READY) or if the Document Type settings disable the submit button. See Configure Document Type Settings.
   • Approve/Reject: Disabled if the document is not in an APPROVAL status type, or if it's not your turn to approve. See Cannot Approve/Reject a Document.
3. Approval Flow Restrictions:
   • Resource Editability: Trying to Save/Update during an approval milestone where resource_editable is set to FALSE. See Configure Resource Editability.
   • Self-Approval Prevention: Trying to Approve/Reject a document you submitted when include_submitter is FALSE. See Submitter Unable (or Able) to Self-Approve Incorrectly.
4. Validation Errors: Blocking (Error level) validation issues are present on the document, preventing Save and Submit or Approve actions. See Document Blocked by Validation.
5. No Changes Made: The Save or Update button might remain disabled if no changes have actually been made to the document data since it was last saved.
6. UI Glitch/State Issue: A temporary front-end issue might cause the button state to be incorrect.

Troubleshooting Steps

1. Check Document Status: Look at the document's current status (next to the document number). Does this status logically allow the action you're trying to perform?
2. Check Approval Flow (If Applicable): If in an Approval status, examine the approval flow display. Is it your turn? Is your status PENDING? Is editing allowed in this milestone (check resource_editable configuration if admin)? Are you the submitter and is self-approval prevented?
3. Check for Validation Errors: Look for red error banners or icons. Resolve any blocking errors first. See Review Validation Issues.
4. Verify Permissions (Admin Task): Confirm with your administrator that your assigned User Groups grant the necessary action permission (e.g., #UPDATE, #SUBMIT, #APPROVE) for the relevant Module/Submodule.
5. Make a Change (for Save/Update): If the Save/Update button is disabled, try making a small, reversible change to a field (e.g., add a space to a note) to see if the button enables. This confirms if the issue was simply that no changes had been detected. Remember to revert the change if not needed.
6. Hard Refresh: Perform a hard refresh of the browser (Ctrl+Shift+R or Cmd+Shift+R) to rule out temporary UI glitches.
7. Log Out/In: Log out of Zudello and log back in.

Need Help?

If a button remains unexpectedly disabled after checking status, permissions, validations, and performing a refresh, contact Zudello support. Provide:

• The Document UUID.
• Which specific button is disabled.
• The current status of the document.
• Confirmation of your user permissions (if known).
• A screenshot showing the disabled button and the document context (status, approval flow if relevant).