=== Project Showcase – Case Studies, Project Portfolio & Project Grid === Contributors: gsplugins, itszaman, samdani Donate link: https://www.paypal.com/donate/?hosted_button_id=K7K8YF4U3SCNQ Tags: project showcase, projects, case study, portfolio, portfolio grid Requires at least: 6.0 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 3.0.5 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Show finished projects as case studies with client, dates, value and project links in a grid, slider or list. No coding needed. == Description == **GS Projects** turns your finished work into case studies that win new clients. Add each project once with its image, description, client, dates, duration, project value and a link to the live result, then display your projects anywhere as a grid, slider, horizontal card or list. Pick a design in the shortcode builder, see it in the live preview, and paste one shortcode or block. Each project gets its own page or popup, so visitors can read the full story without leaving your projects page. 👉 [Live demo](https://projects.gsplugins.com/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=demo) · [Documentation](https://docs.gsplugins.com/gs-projects/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=docs) · [Pro features](https://www.gsplugins.com/product/wordpress-projects-showcase-plugin/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=top-overview) · [Pricing](https://www.gsplugins.com/product/wordpress-projects-showcase-plugin/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=top-link) · [Support](https://www.gsplugins.com/contact/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=support) ### Who it's for * **Agencies and freelancers:** client projects and case studies with results. * **Developers:** websites and apps you've built, with links to the live sites. * **Construction, architecture and engineering firms:** completed projects with client, duration and value. * **Consultants and service businesses:** past engagements that prove you can deliver. ### Why site owners choose GS Projects * **Built for case studies:** fields for tagline, client, start and end dates, duration, project value, project URL and extra details of your own. * **Set up in minutes:** a dedicated Projects menu, a shortcode builder with live preview, and one-click demo data. * **Looks right on every screen:** set columns for desktop, tablet and mobile. * **Works with your builder:** Gutenberg block, Elementor, Divi, WPBakery, Beaver Builder, Oxygen and the Newspaper theme. ### Free features * **8 designs** across grid, slider, horizontal and list layouts. * **Shortcode builder with live preview:** create, edit, clone and delete project shortcodes. * **Open projects in a popup** or on a single project page. * **Project details:** tagline, client name, start and end dates, duration, project value, project URL and additional custom fields. * **Responsive columns** for desktop, tablet and mobile. * **Categories and tags:** include or exclude them to choose which projects appear. * **Sorting** by date, title or ID. * **Typography settings** for titles, taglines and details. * **Custom image sizes.** * **Unlimited projects.** * **Custom CSS** and **template overrides** in your child theme. * **Translation ready.** ### Pro features [GS Projects Pro](https://www.gsplugins.com/product/wordpress-projects-showcase-plugin/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=pro-section) adds: * **Filter view:** category tabs so visitors can sort your projects. * **Masonry view.** * **57 more designs,** including metro, justified, timeline and extra grid, slider, horizontal and list designs. * **Client review and star rating** on each project. * **Image galleries, video and audio** for each project. * **Skills or technologies** and **project status** (completed, in progress and more). * **Drag-and-drop custom order** for projects. * **More popup, arrow and dot designs.** * **Priority email support.** Plans start at $49 per year, with a 7-day money-back guarantee. [Compare Pro plans](https://www.gsplugins.com/product/wordpress-projects-showcase-plugin/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=pro-plans). ### How it works 1. Go to **GS Projects > Add New Project**. Add the title, description and featured image, then fill in the client, dates, value and project URL, and choose a category. 2. Go to **GS Projects > Shortcode**, create a shortcode and pick a view and design. The live preview updates as you change settings. 3. Copy the shortcode, for example `[gsprojects id=1]`, into any page or post, or use the GS Projects block or widget in your page builder. Each shortcode has three tabs: * **General:** view, design, link type (popup or single page), image size and which details to show. * **Style:** columns per device and typography for titles, taglines and details. * **Query:** how many projects to show, sorting, and which categories and tags to include or exclude. ### Shortcode usage `[gsprojects id=1]` In a theme file: `` See the [documentation](https://docs.gsplugins.com/gs-projects/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=shortcode-docs) for every option. ### Support Free users get help in the [WordPress.org support forum](https://wordpress.org/support/plugin/gs-projects/). Pro users get priority email support through our [help desk](https://www.gsplugins.com/contact/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=support-section). We reply as soon as we can, excluding holidays. ### More plugins from GS Plugins * [GS Logo Slider](https://wordpress.org/plugins/gs-logo-slider/): client, partner and sponsor logos in sliders, carousels, tickers and grids. * [Solid Testimonials](https://wordpress.org/plugins/gs-testimonial/): customer reviews and quotes in sliders, grids and masonry layouts. * [GS Team Members](https://wordpress.org/plugins/gs-team-members/): team pages and staff directories with profiles and social links. * [GS Portfolio](https://wordpress.org/plugins/gs-portfolio/): show your work in grid, slider, list and filterable layouts. * [GS Books Showcase](https://wordpress.org/plugins/gs-books-showcase/): books with authors, ratings and galleries in 35+ designs. * [GS Coaches](https://wordpress.org/plugins/gs-coach/): coach and trainer profiles with skills and certifications. * [GS Posts Grid](https://wordpress.org/plugins/posts-grid/): blog posts in 50+ grid, list and slider styles. * [GS WooCommerce Products Slider](https://wordpress.org/plugins/gs-woocommerce-products-slider/): product sliders and carousels for your shop. * [GS Variation Swatches](https://wordpress.org/plugins/gs-woo-variation-swatches/): color, image and button swatches for WooCommerce variations. * [GS WooCommerce Brands](https://wordpress.org/plugins/gs-woo-brands/): add brands to products with logos, filters and sliders. * [GS Pinterest Portfolio](https://wordpress.org/plugins/gs-pinterest-portfolio/): embed Pinterest pins and boards. * [GS YouTube Gallery](https://wordpress.org/plugins/gs-youtube-gallery/): YouTube videos, playlists and channels in galleries. * [PowerUp](https://wordpress.org/plugins/powerup/): redirects, restrictions and admin tools for WordPress. == Installation == = From your WordPress dashboard = 1. Go to **Plugins > Add New** and search for **GS Projects**. 2. Click **Install Now**, then **Activate**. 3. A **GS Projects** menu appears in your dashboard. = By uploading the zip file = 1. Download `gs-projects.zip`. 2. Go to **Plugins > Add New > Upload Plugin**, choose the file and click **Install Now**. 3. Activate the plugin. = By FTP = 1. Upload the `gs-projects` folder to `/wp-content/plugins/`. 2. Activate the plugin from **Plugins** in your dashboard. Then add `[gsprojects id=#]` where you want the projects to show. See the [setup guide](https://docs.gsplugins.com/gs-projects/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=install-docs) for screenshots of each step. == Frequently Asked Questions == = How do I add a project? = Go to **GS Projects > Add New Project**. Enter the title, description and featured image, fill in the project details and choose a category. Then publish. = How many projects can I add? = As many as you need. There is no limit in the free version. = What image size works best? = At least 500 × 500 pixels. Use the same shape for every project so the grid lines up. If older images look the wrong size, regenerate thumbnails with a plugin such as Regenerate Thumbnails. = How is this different from GS Portfolio? = GS Projects is built for case studies: each project has a client, dates, duration, value and a link to the live result. GS Portfolio is better for showing visual work such as designs or photos. = Can visitors filter projects by category? = Yes, with Pro. The filter view adds category tabs above your projects. In the free version you can create a separate shortcode for each category. = Can I show client reviews and ratings? = Yes, with Pro. Each project can show the client's review and a star rating. = Can I add videos or image galleries to a project? = Yes, with Pro. Each project can have an image gallery, a video or an audio file. = Can I link a project to the live website? = Yes. Add the project URL and visitors can open the live site or full case study. = How do I show projects in alphabetical order? = In the shortcode's Query settings, set **Order By** to **Title** and **Order** to **ASC**. = Does it work with Elementor, Divi and other page builders? = Yes. It has a Gutenberg block and native widgets or modules for Elementor, Divi, WPBakery, Beaver Builder, Oxygen and the Newspaper theme. In any other builder, paste the shortcode. = Why does my single project page show a 404 error? = WordPress needs to refresh its links. Go to **Settings > Permalinks** and click **Save** once. = How do I use the shortcode in a theme template? = Use `` and replace 1 with your shortcode's ID. = What is the difference between the free and Pro versions? = The free version gives you 8 grid, slider, horizontal and list designs, popups, single project pages, the main case study fields and unlimited projects. Pro adds filter and masonry views, 57 more designs, client reviews and ratings, galleries, video, audio, skills, project status, drag-and-drop order and priority support. See the [Pro features and plans](https://www.gsplugins.com/product/wordpress-projects-showcase-plugin/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=wordpress-projects-showcase-plugin&utm_content=faq-pro). == Screenshots == 1. Grid design 1. 2. Grid design 5. 3. Horizontal design 3. 4. Horizontal design 6. 5. Slider design. 6. Timeline design. 7. Masonry design. 8. Metro design. 9. Justified design. 10. Filter view with popup. 11. List of saved shortcodes. 12. General settings. 13. Style settings: typography. 14. Query settings. 15. Preferences. 16. Drag-and-drop custom order. == Changelog == = Version 3.0.5 [27th Oct 2026] = * [Fixed]: Broken pricing links. = Version 3.0.4 [29th Sep 2026] = * [Fixed]: Taxonomy switcher. = Version 3.0.3 [20th Aug 2026] = * [Updated]: Sort doc link. = Version 3.0.2 [23rd Jun 2026] = * [Fixed]: Broken pro link. = Version 3.0.1 [3rd Jun 2026] = * [Added]: Gutenberg block options. * [Fixed]: Taxonomy ordering issues. * [Fixed]: Block loading and textdomain issues. * [Updated]: Block name for WordPress.org compatibility. * [Updated]: Icons for all addons. = Version 3.0.0 [5th Mar 2026] = * [Updated]: Rewritten the plugin. = Version 1.1.2 [4th Nov 2024] = * [Updated]: Shortcode Attributes. * [Updated]: Security Issue. = Version 1.1.1 [25th Jan 2023] = * [Updated]: Free, Pro Plugins Pages & Help Page. * [Removed]: All Admin Notices From Projects Post Type. = Version 1.1.0 [23rd May 2021] = * [Fixed]: PHP 7.3 Compatibility. * [Fixed]: Deprecated Function Warning. = Version 1.0.9 [19th May 2021] = * [Fixed]: AppSero conflicts with other plugins. = Version 1.0.8 [19th Dec 2020] = * [Updated]: AppSero Client. * [Updated]: With WordPress version 5.6 = Version 1.0.7 [13th Aug 2020] = * [Updated]: With WordPress latest version. = Version 1.0.6 [24th Jun 2020] = * [Updated]: Appsero Client. = Version 1.0.5 [21st Jun 2020] = * [Updated]: strip_tags() on get_the_content = Version 1.0.4 [3rd Apr 2020] = * [Updated]: Bootstrap 3 to Bootstrap 4. = Version 1.0.3 [23rd Nov 2019] = * [Fixed]: Domain name with www & fixed all urls. * [Updated]: With WordPress latest version. = Version 1.0.2 [21st Oct 2019] = * [Fixed]: Domain name changed & fixed all urls. * [Added]: New Contributors. = Version 1.0.1 = * Initial release == Upgrade Notice == = 3.0.5 = Fixes broken pricing links.