Common Issues

Quick fixes for the most frequent problems.

I can't see the Grid Browser tab

• Open App Launcher → Appcolab Grid — the tabs live inside that app.
• If it isn't in your App Launcher, ask an admin to assign the Appcolab_Grid_User or Appcolab_Grid_Admin permission set.

The Grid Browser is empty

• Filter by Status = Active (admins see inactive grids by default).
• Confirm grids exist under Grid Definition tab (admin only).
• Confirm your permission set is assigned.

"Limit Exceeded" when opening a grid

The org has more active grids than the license allows. Contact your admin. They can:

• Deactivate grids on the Grid Administration tab until the count is within the limit.
• Or purchase additional licenses.

See Grid Administration.

Grid loads but shows no rows

• Check your filters — you may have an overly narrow runtime filter. Click Reset Grid to go back to the admin default.
• Confirm you have read access to the primary object and that sharing rules allow you to see records.
• Admin filter may exclude records (ask your admin).

Embedded grid on a record page shows every record (not scoped)

The Grid Definition's Parent Relationship Field is not set or points to the wrong lookup.

• Open the Grid Definition in the wizard.
• On Grid Details, set Parent Relationship Field to the API name of the lookup that ties the primary object to the parent record (for example, AccountId when embedding a Contact grid on an Account page).
• Save and reload the record page.

See Adding Grids to Pages.

Embedded grid shows "Grid not found"

• The Grid Definition Name on the Lightning page component doesn't match any active Grid Definition.
• Verify the Name on the Grid Definition exactly matches (case-sensitive) what was entered in the Lightning App Builder.
• Confirm the grid is Active.

Inline edit save fails for every row

• You probably don't have FLS edit access to one of the fields.
• Or a validation rule is rejecting the save — read the error toast carefully for the rule's message.
• Or the record is read-only due to sharing — only rows you can edit are editable in the grid.

CSV download is missing rows (server-side pagination)

On server-side pagination, the CSV only includes pages you've loaded. Either:

• Scroll through all pages to load them, then re-download.
• Ask an admin to switch the grid to Client-Side pagination for full exports.

Search or filter isn't matching what I expect

• Global search only matches text-like fields that are visible.
• Use Filter for numbers, dates, picklists, and other non-text fields.
• Remember the admin filter still applies — you cannot find records hidden by it.

A custom Flow/Apex action does nothing or errors

• Confirm your permission set includes access to the Flow and/or the Apex class.
• Ask your admin to check the Apex class implements GridApexActionInterface correctly and the class name in the action config matches exactly.
• Check your browser console for a detailed error message.

The grid feels slow

• Hide columns you don't need via Column Settings — fewer columns render faster.
• Narrow your view with filters.
• For very large datasets, ask your admin to switch the grid to Server-Side pagination.

I changed the grid config but users still see the old version

• Have them click Refresh in the grid toolbar.
• If they customized their view heavily, have them click Reset Grid to pick up the new admin defaults.
• In stubborn cases, a hard browser refresh (Ctrl+Shift+R / Cmd+Shift+R) clears cached metadata.

Something else

• Check the Notes page for known limitations.
• Contact your administrator, or file a support ticket with the exact grid name, the action you took, and any error message shown.