A collection of common questions and guidance from ValidMind support.
Q: Should someone with the role of validator be able to upload development documentation for a model?
Area: Documentation
A: By default, validators typically have read-only access to development documentation. To allow validators to upload documentation, you need to modify the role permissions in Settings > Roles & Permissions. Check the 'Write' permission for Development Documentation under the Validator role.
Area: Model Inventory
A: Developers need the 'Workflow Management' permission enabled in their role. Go to Settings > Roles & Permissions > Developer role, and ensure 'View Workflows', 'Edit Workflows', and 'Create Workflows' are checked.
Area: Documentation
A: These permissions control whether users can add or remove content blocks within documentation sections. 'Add Block Doc' allows inserting new content blocks, while 'Remove Block Doc' allows deleting existing blocks from documents.
Q: Unable to use formatting text in model inventory attribute (long text type) - clicking formatting options dismisses the screen.
Area: Model Inventory
A: This was a known issue that has been fixed in version 26.01. Please upgrade to the latest version. If you're already on 26.01+, try refreshing the page or clearing browser cache.
Q: Changes to an individual model's monitoring document are registering as changing the template instead.
Area: Documentation
A: This is expected behavior in some cases - if you modify a section that's linked to the template, it may show as a template change. To avoid this, ensure you're editing model-specific content rather than template-linked sections. You can unlink a section from the template if needed.
Area: Documentation
A: ValidMind supports configurable LLM backends. Contact your administrator to check which models are enabled in your deployment. Reasoning level configuration depends on the specific model being used.
Q: AI/ML determination checkbox information isn't saving - when trying to edit the field after hitting submit, it unchecks the boxes and edits don't save.
Area: Model Inventory
A: This issue was related to field validation timing. It was fixed in version 26.01. If you're experiencing this, please upgrade to the latest version or contact support with browser console logs.
Q: What should happen after a workflow user action deadline has expired? What does 'expire action' mean?
Area: Workflow
A: When a deadline expires, the workflow can be configured to: (1) automatically move to the next step, (2) notify designated users, or (3) mark the action as expired requiring manual intervention. The specific behavior depends on your workflow configuration.
Q: Workflow approval configuration: I set up either a role OR stakeholder to approve, but after approving, the workflow doesn't move forward.
Area: Workflow
A: When using OR logic for approvals, ensure the approval node is configured for 'Any' rather than 'All' approvers. Also verify no other blocking conditions exist on the approval node.
Q: Can we change the duration of a workflow? Our IRA remediation workflow has a 2-week duration marking items as late.
Area: Workflow
A: Yes, workflow durations can be modified in Settings > Workflows > [Your Workflow] > Duration. Note that changes only affect newly started workflow instances, not existing ones.
Area: Workflow
A: Duration changes apply to workflow templates but may not retroactively update models already in a workflow. You may need to restart the workflow for affected models to pick up the new duration settings.
Area: Workflow
A: This can occur if: (1) the approval node requires multiple approvers and not all have approved, (2) there's a condition on the transition that isn't met, or (3) there's a system delay. Try refreshing, or contact support with the workflow ID for investigation.
Area: Reporting
A: 500 errors during export typically indicate: (1) the document is too large, (2) there's malformed content in a section, or (3) a temporary server issue. Try exporting individual sections to identify problematic content. Contact support with HAR file if the issue persists.
Q: Date format in exported files changed unexpectedly - now includes 'Z' suffix and different time component, breaking downstream processes.
Area: Model Inventory
A: The 'Z' suffix indicates UTC timezone (ISO 8601 format). This was standardized for consistency. Update your downstream processes to handle ISO 8601 format, or contact support if you need the previous format restored.
Area: Reporting
A: Currently, pie charts show visual breakdowns without percentages. You can export the underlying data and calculate percentages externally, or submit a feature request for built-in percentage display.
Q: 'Session expired' popup loop with uBlock Origin and Firefox - clicking OK reloads but popup returns.
Area: Authentication
A: This occurs because uBlock Origin blocks analytics scripts (heap) that ValidMind uses for session validation. Whitelist app.validmind.ai in uBlock Origin or disable it for ValidMind sites to resolve the loop.
Q: Unable to insert a content block at the beginning of a section - can only insert after existing blocks.
Area: Documentation
A: This is a known UX limitation. Workaround: create the new block after the first block, then use drag-and-drop to reorder it to the beginning of the section.
Area: Documentation
A: Yes, guidance fields support Markdown formatting. Use standard Markdown syntax: blank lines for paragraphs, dashes with indentation for nested lists, and pipe-delimited tables. Example: '- Item 1\n - Nested item'
Q: Trying to upload a large documentation file (212MB) but getting 'Error Creating Document. Network Error.'
Area: Documentation
A: There's a file size limit for document uploads (typically 50-100MB depending on deployment). For large files, consider: (1) compressing the file, (2) splitting into multiple smaller documents, or (3) linking to external storage.
Q: Is it possible to show options as group and sub-group (e.g., Marketing > Digital Marketing) in Business Units field?
Area: UI / UX
A: Hierarchical/nested dropdowns are supported for Use Case fields. For Business Units, you can achieve similar results by using a naming convention (e.g., 'Marketing - Digital Marketing') or requesting the feature be enabled for your organization.
Q: Manage Columns selections in Artifacts don't persist - when navigating away and back, columns revert to default.
Area: UI / UX
A: Column preferences are stored in browser local storage. Clear your browser cache and re-apply settings. If the issue persists, it may be a browser extension conflict. Try in incognito mode to verify.
Q: General Admin users can only see limited columns (owner, use case, developers, stage, etc.) in inventory view.
Area: RBAC
A: Column visibility is controlled by role permissions. Check that the General Admin role has 'View' permissions for the fields that should be visible. Go to Settings > Roles & Permissions to verify field-level access.
Area: Developer Library
A: Yes, log_text writes to a specific content block identified by its ID in the document template. You cannot run log_text in Python and then manually add it later - the content block must exist in the template first.
Area: Security
A: ValidMind regularly patches security vulnerabilities. Please specify the CVE numbers from your scan, and our security team will provide remediation timelines. Some flagged vulnerabilities may be false positives or already mitigated.
Area: User Management
A: Profile information is typically synced from your identity provider (SSO/OKTA). Contact your IT admin to correct the name in the identity provider, or contact ValidMind support if you use local authentication.
Area: Model Inventory
A: This feature allows a single field to reference multiple related records (e.g., linking one model to multiple upstream models). Enable it when you need many-to-many relationships between records.
Area: Reporting
A: Analytics visibility depends on role permissions and data availability. Check that: (1) your role has Analytics access enabled, (2) there's sufficient data in the system for charts to render. Contact your admin to verify permissions.