A browser extension that lets you customize YouTube's homepage layout by adjusting the number of video columns in the grid.
- Customize the number of video columns (1-8) on YouTube's homepage
- Responsive design that automatically adjusts thumbnail sizes based on window width
- Maintains proper aspect ratio for videos
- Preserves YouTube's Shorts section in its original format
- Clean, minimal interface
- Visit Firefox Add-ons Page WE ARE LIVE!!!
- Click "Add to Firefox"
- Download or clone this repository
- Open Firefox and navigate to
about:debugging - Click "This Firefox" in the sidebar
- Click "Load Temporary Add-on"
- Navigate to the extension directory and select
manifest.json
This extension is compatible with Chromium-based browsers (Chrome, Brave, Edge) via the WebExtensions API.
- Clone or download this repository
- Open your browser’s extensions page
- Enable Developer Mode
- Choose “Load unpacked”
- Select the extension directory
- Navigate to YouTube's homepage
- Click the extension icon in the Firefox toolbar
- Adjust the column slider to your preferred number of columns (1-8)
- Click "Apply Layout" to see the changes
- The extension will remember your settings between browser sessions
The extension uses CSS Grid to modify YouTube's layout, allowing for a customizable number of columns while maintaining proper spacing and thumbnail sizes. It carefully targets only the main video grid without affecting special content like Shorts.
youtube-grid-customizer/
├── manifest.json # Extension configuration
├── icons/ # Extension icons
│ ├── icon-48.png
│ └── icon-96.png
├── popup/ # User interface
│ ├── popup.html
│ ├── popup.css
│ └── popup.js
├── content_scripts/ # YouTube page modifications
│ └── thumbnailResizer.js
└── background.js # Background script
- Clone the repository
- Make any desired changes
- Test using Firefox's about:debugging page
- Package using web-ext:
web-ext build
- Works with Firefox 146.0
- Tested with YouTube's layout as of Jan 2026
- Works with Brave v 1.85.118
- Tested with YouTube's layout as of Jan 2026
- On some YouTube layout updates, a page refresh may be necessary to apply changes
- The extension only affects the main YouTube homepage and video browsing pages
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Created for personal use and shared with the community
- Inspired by the need for a more customizable YouTube browsing experience