🔧 Key Actions After Updates: Understanding How Bundle Updates impact roles and Center Tab

When we push updates to our NetSuite payroll SuiteApp, NetSuite's bundle management system may reset certain role configurations and center tab visibility. This is standard NetSuite behavior for managed SuiteApps, not a bug in our application.

Why This Happens

Our SuiteApp uses managed bundles, which means NetSuite controls certain update behaviors. NetSuite's SuiteApp framework preserves core functionality but may reset UI customizations to ensure compatibility with our latest features. This includes:

• Center tab audience assignments
• Custom role preference modifications
• Subsidiary-specific role permissions (for OneWorld accounts)

🚨 Critical: Payroll Administrator Role Access

The most common issue after our SuiteApp updates is that users assigned the Payroll Administrator role lose access to payroll functionality. Changes typically appear within 15-30 minutes after we complete the bundle push to your account.

📋 Quick Action Checklist

Immediate Post-Update Actions (5-10 minutes):

🎯 Essential Steps for Payroll Access (Payroll Administrators)

Important: These steps require the Custom Records feature to be enabled in your NetSuite account. If you cannot access the navigation paths below, contact your NetSuite administrator to enable this feature under Setup > Company > Enable Features > SuiteCloud > Custom Records.

1. Restore Payroll Center Tab Visibility

If users cannot see the Payroll Center tab after our update:

What to do:

1. Go to Customization > Centers and Tabs > Center Tabs
2. Locate and edit the "Payroll Center" entry (or your organization's equivalent payroll tab)
3. Under the Audience subtab, reselect the roles or groups that should have access
4. Ensure Payroll Administrator (or your organization's equivalent payroll role) is selected in the roles list
5. Save the changes
6. Clear browser cache and have users log out and back in for changes to appear

Note: Center tab visibility is controlled at the tab level through Audience settings, not through individual role preferences.

2. Reactivate Custom Payroll Roles

If you've created custom payroll roles and marked them as inactive, SuiteApp updates may revert them back to active status.

What to do:

1. Go to Setup > Users/Roles > Manage Roles
2. Locate any previously inactive custom payroll roles
3. Manually reapply the inactive status
4. Save changes

This occurs because role status is not always preserved across managed bundle updates.

3. 🔑 Permissions Reset After Bundle Update

If your users experience missing permissions (like the 'Log In Using SAML Single Sign-on' permission) immediately following a bundle update, this is expected behavior.

What Happens?

To maintain the integrity of our product, our bundle update process resets bundled roles to their default configuration. Any permissions manually added to these roles (such as the SSO permission you added for a specific feature) are removed during the update.

Action Required

Your NetSuite Administrator must re-apply the missing permissions to the affected bundled role(s) to restore access.

1. Navigate: Go to Setup > Users/Roles > Manage Roles.

2. Edit: Edit the affected bundled role.

3. Restore: Under the Permissions tab, manually re-add the missing permission(s) (e.g., 'Log In Using SAML Single Sign-on' under the Setup sub-tab, Level: Full).

Tip: You can see changes on the history tab on the role.

This manual restoration will be required after any future bundle updates until a permanent patch is released.

🔧 Additional System Checks (NetSuite Administrators)

Important: These checks apply only if your organization has made customizations to NetSuite - either during initial implementation or ongoing internal modifications. If you're unsure whether these apply to you, contact your NetSuite administrator or IT team.

4. Review Custom Fields on Employee Records

When this matters: If custom fields were added to employee records (during implementation or by your team afterward) such as department codes, custom pay rates, or compliance fields.

How to check:

1. Go to Lists > Employees > Employees
2. Open any employee record
3. Look for custom fields that should appear but are missing or misaligned
4. Check the Custom subtab for field visibility

What to look for: Missing custom fields, fields moved to wrong subtabs, or fields that lost their default values.

5. Verify Custom Transaction Forms (If Used)

When this matters: If your team has created or modified payroll entry forms at any point.

How to check:

1. Go to Customization > Forms > Transaction Forms
2. Look for any forms with "payroll" or your company name in the title
3. Check that these forms are still marked as Preferred for the correct roles

What to look for: Custom forms no longer set as preferred, missing fields on forms, or layout changes.

6. Test Custom Workflows (If Created)

When this matters: If workflows were created for payroll approvals, notifications, or data validation - whether during implementation or built internally afterward.

How to check:

1. Go to Customization > Workflow > Workflows
2. Filter by "payroll" or look for workflows your team has created
3. Verify these workflows are still Active
4. Test the workflow by creating a test transaction (if safe to do so)

What to look for: Workflows marked inactive, or workflows not triggering as expected.

7. Validate Custom Saved Searches and Reports

When this matters: If custom payroll reports were built by your team or implementation partner.

How to check:

1. Go to Reports > Saved Searches
2. Look for searches with "payroll" in the name or searches your team has customized
3. Run these searches to ensure they return expected results
4. Check that they're still shared with the right roles

What to look for: Searches returning errors, missing data, or no longer shared with Payroll Administrator role.

8. OneWorld: Subsidiary-Specific Settings

When this matters: If you use NetSuite OneWorld and have subsidiary-specific payroll configurations.

How to check:

1. Go to Setup > Users/Roles > Manage Roles
2. Edit the Payroll Administrator role
3. Check the Subsidiaries subtab to ensure correct subsidiary access
4. Verify any subsidiary-specific restrictions are still in place

What to look for: Missing subsidiary access or incorrect restrictions.

9. Integration Settings (If Applicable)

When this matters: If your payroll data integrates with other systems (HRIS, time tracking, etc.) through connections set up by your team or vendors.

How to check: Contact your IT team to verify:

• API connections still function
• Data mapping remains intact
• Scheduled imports/exports still work

Note: This typically requires technical expertise and may need vendor support.

💡 Not Sure What Applies to You?

Contact your internal NetSuite administrator or IT team if:

• You're unsure what customizations have been made over time
• You don't have documentation of custom workflows, fields, or forms created by your team
• You experience unexpected behavior beyond the basic access issues covered above

Contact your original implementation partner if:

• You need help identifying what was set up during initial implementation
• You require assistance with complex customizations

Contact our support team if:

• Basic payroll functionality isn't working after following the critical steps above
• You need help determining whether an issue is related to our SuiteApp or your customizations

❓ Frequently Asked Questions

Q: Why doesn't this happen with other NetSuite features? A: Our payroll SuiteApp creates custom center tabs and modifies role permissions. NetSuite's managed bundle system resets these customizations to ensure app stability during updates.

Q: Can we prevent this from happening? A: No - this is controlled by NetSuite's SuiteApp framework. However, the fixes are quick (typically 5-10 minutes) and only needed after our major app updates.

Q: Will this affect our payroll processing? A: No - payroll data and processing remain intact. Only UI access is affected, and can be restored immediately using the steps above.

Q: How often do these updates occur? A: We release SuiteApp updates as needed for new features and bug fixes. You'll receive email notifications before updates are pushed to your account.

Q: What if the Payroll Center tab is still missing after following these steps? A: First, verify the Custom Records feature is enabled (Setup > Company > Enable Features > SuiteCloud > Custom Records). Then clear your browser cache completely and try logging out/in again. If issues persist, contact our support team with your NetSuite account ID.

🎯 Recommendations

• Bookmark this article and review it immediately after receiving our SuiteApp update notification emails
• Assign a NetSuite Administrator to perform these checks after each update
• Test payroll access with an end user before the next payroll cycle

🔍 Found Other Issues?

If you experience problems not covered in this guide and that impact payroll behavior after our SuiteApp update, please contact our support team with details about:

• What functionality stopped working
• The exact error message (if any)
• Your NetSuite account ID
• Which role(s) are affected

This helps us improve our guidance for future updates and ensures we can assist you quickly.

🆘 Support

If you continue experiencing access issues after following these steps, this indicates a NetSuite role configuration issue rather than a problem with our SuiteApp. Contact our support team with your NetSuite account ID and affected user details.

This guide applies to NetSuite customers using managed SuiteApps. Only affects accounts where custom role configurations have been made to the default Payroll Administrator role.