Troubleshooting

This guide covers common issues and troubleshooting steps for Supaship.

Common Issues

• Feature flag not working
• Feature changes not reflecting
• API key issues
• Context object issues
• Edge cases with targeting rules
• Performance issues
• Error messages

General Troubleshooting Steps

1. Verify your API key is correct (32 characters, and a suffix of -client or -server).
2. Check that the feature flag name matches exactly (case-sensitive).
3. Ensure the SDK is properly initialized.
4. Verify the feature is enabled (on) in the correct environment.
5. Check if targeting rules are preventing the flag from being evaluated.

Context Object Issues

Problem: Context object is not properly configured

Solutions:

1. Verify the context object contains required properties (userID, email, etc.).
2. Check for any missing properties in the context object.
3. Ensure the context object is properly serialized.

Edge Cases with Targeting Rules

Problem: Edge cases with targeting rules are not working

Solutions:

1. Verify the targeting rules are properly configured.
2. Check for any missing targeting rules.
3. Ensure the targeting rules are properly serialized.

Feature Flag Not Working

1. Verify your API key is correct (32 characters, no prefixes)
2. Check that the feature flag name matches exactly (case-sensitive)
3. Ensure the SDK is properly initialized
4. Verify the feature is enabled in the correct environment
5. Check if targeting rules are preventing the flag from being enabled

Feature Changes Not Reflecting

Problem: Feature flag changes don’t appear immediately

Solutions:

1. Wait a few seconds for propagation.
2. Verify the feature targeting rules are properly configured in the right environment.
3. Try refreshing the page or clearing cache.

API Key Issues

Problem: “Invalid API key” or “Unauthorized” errors

Solutions:

1. Ensure the API key is exactly 32 characters and has a suffix of -client or -server.
2. Remove any prefixes or extra whitespace.
3. Copy the key from the API Keys section of project settings.
4. Use Client Key for frontend apps, Server Key for backend services.
5. Verify the key belongs to the correct project.