Troubleshooting

Encountering issues with theme installation or configuration? Here are some common problems and solutions:

Common Issues

Theme Not Installing

If you're having trouble installing a theme, ensure that you have the correct theme package and that it is compatible with your version of Oqtane. Also, check for any errors in the installation process.

Theme Appearance Not Changing

If you've installed a theme but don't see any changes on your site, try clearing your browser cache and refreshing the page. Additionally, check if the theme is activated and configured correctly in the Theme Management section.

Error Messages

If you encounter error messages during theme installation or configuration, note down the error message and any accompanying details. Search for solutions online or consult the Oqtane community forums for assistance.

Troubleshooting Steps

1. Check Compatibility: Ensure that the theme is compatible with your version of Oqtane and any other installed modules or themes.

2. Review Configuration: Double-check the theme configuration settings to ensure that everything is configured correctly.

3. Inspect Logs: Look for error messages or warnings in the Oqtane log files, located in the /Logs directory of your Oqtane installation.

4. Update Dependencies: Make sure that all dependencies required by the theme are up-to-date and installed correctly.

5. Contact Support: If you're unable to resolve the issue on your own, reach out to the theme developer or the Oqtane community for assistance.

By following these troubleshooting steps, you should be able to diagnose and resolve most theme-related issues on your Oqtane site.