=== Twentig Supercharged Block Editor – Blocks, Patterns, Starter Sites, Portfolio ===
Contributors: twentig
Donate link: https://twentig.com/donate/
Tags: block editor, blocks, wordpress blocks, patterns, portfolio
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Supercharge the WordPress block editor with enhanced core blocks, hundreds of block patterns, professional starter sites, and portfolio tools.

== Description ==

### The easy way to build a beautiful website with the WordPress block editor.

👉 **Want to try Twentig? [Launch the Playground](https://twentig.com/playground/?utm_source=wp-repo&utm_medium=link&utm_campaign=playground)**

Twentig gives you simple, powerful tools to design a professional website with the WordPress block editor — no coding or design skills required. Customize your block theme, create polished pages, and build a site that fits your needs.

With starter sites, enhanced WordPress core blocks, block patterns, and portfolio tools, you’ve got everything you need to create a stunning website that looks great on every device.

For the best experience, pair the Twentig plugin with [Twentig One](https://twentig.com/twentig-one/) — our free block theme built for WordPress Full Site Editing. Lightweight and beautifully designed, it gives you a professional foundation right out of the box.

### Starter sites

Start with a professionally designed website, not a blank canvas. Import a ready-made [starter site](https://twentig.com/starter-sites/?utm_source=wp-repo&utm_medium=link&utm_campaign=starter) from our growing library and make it your own.

Twentig includes starter sites for the Twentig One theme directly in your WordPress dashboard. Import a starter site with one click, then customize the header, footer, homepage, blog, colors, and typography with our Onboarding Customizer.

https://youtu.be/604lIiUruWI

From there, use the block editor to easily replace the content with your own text and images.

Built-in starter sites for Twentig One:

* [Business Starter](https://twentig.com/starter-site/business-starter/)
* [Portfolio Starter](https://twentig.com/starter-site/portfolio-starter/)
* [Blog Starter](https://twentig.com/starter-site/blog-starter/)
* [Personal Starter](https://demo.twentig.com/personal-starter/)

Twentig also includes starter sites for the Twenty Twenty-Five and Twenty Twenty-Four themes.

### Enhanced WordPress blocks

Twentig enhances WordPress core blocks — giving you more design flexibility and creative control in the block editor.

**Powerful block features.** Twentig adds new settings, alternative styles, and CSS classes to the existing WordPress blocks. From scroll animations, hover effects, and image shapes to gallery sliders, button icons, video lightboxes, and fully clickable blocks — you’ve got everything you need to build modern, professional pages.

**No extra blocks. Just better ones.** Instead of cluttering the block editor with additional blocks, Twentig enhances WordPress core blocks with essential features for a more intuitive editing experience, greater creative freedom, and no lock-in.

Twentig extends the following WordPress blocks:

#### Design blocks

* **Accordion:** icon
* **Button:** icon, icon position, video lightbox (YouTube, Vimeo, self-hosted video)
* **Columns:** responsive stacking layout
* **Column:** stretched link (make the column fully clickable)
* **Group:** stretched link (make the group fully clickable), hover styles (text color, background color, border color, shadow), shape separator
* **Separator:** styles (asterisks, dotted, dashed), width, height

#### Media blocks

* **Image:** shape
* **Gallery:** justified and carousel/slider layouts (available as block variations), unstretch last row, responsive layout, vertical alignment
* **Cover:** stretched link (make the cover fully clickable), shape, hover effect
* **Media & Text:** styles (shadow, overlap, hard shadow), responsive layout, stretched link, full height
* **Video:** autoplay when in view, minimal controls

#### Text blocks

* **Paragraph:** typography options, responsive alignment
* **Heading:** typography options, responsive alignment
* **List:** styles (square, dash, checkmark, arrow, border, inner border, table, no bullet, inline)
* **Quote and Pullquote:** style (icon)
* **Details:** icon
* **Table:** styles (border, inner border), vertical alignment

#### Theme blocks

* **Navigation:** responsive breakpoint, menu icon size, hover style, active style
* **Navigation Link:** external link class
* **Submenu:** classes (rounded, shadow, no-border, align right)
* **Site Logo:** image width on mobile
* **Query Loop:** single-post filters (exclude current post, filter by category or tag)
* **Post Template:** responsive columns, class layouts (alt columns, alt spacer, alt grid)
* **Pagination:** spacing support (margin and padding), page number styles (square, rounded, circle, plain), previous and next page styles (square, rounded, pill)
* **Title:** typography options, responsive alignment
* **Excerpt:** option to display only the manual excerpt
* **Featured Image:** shape, hover effect
* **Author:** inline layout, avatar shape
* **Categories and Tags:** styles (outline, pill, hashtag, plain, list), unlink
* **Previous Post and Next Post:** style (stack)

#### Widget blocks

* **Search:** style (underline)
* **Social Icons:** styles (square, rounded), hover effect
* **Tag Cloud:** styles (rounded, pill, plain, list)

Twentig also lets you add animations to any WordPress core block. Choose from fade, slide, scale, or wipe effects, then customize the speed and delay to make your pages feel more dynamic.

### Block patterns

Twentig includes hundreds of pre-designed block patterns — making it faster and easier than ever to create stunning pages in the WordPress block editor.

**Flexible block patterns.** Choose from a versatile collection of block patterns you can mix and match to fit your project. Our block pattern library is built to support a wide range of use cases, giving you the flexibility to create the pages and sections you need.

**Professional design.** All patterns are fully responsive and designed to give your pages a polished, professional look from the start.

**Theme block patterns.** Twentig also includes dozens of pre-built patterns for your header, footer, blog, and portfolio — helping you customize every part of your website with ease.

Twentig adds its pattern library to the Patterns tab of the block inserter in the following categories:

* Banners
* Call to Action
* Contact
* Events, Schedule
* FAQs
* Gallery
* Hero
* List
* Logos, Clients
* Media
* Numbers, Stats
* Pages
* Portfolio
* Posts
* Pricing
* Single Pages
* Team
* Columns
* Testimonials
* Text
* Text and Image

### Portfolio

Twentig provides all the WordPress tools you need to create a portfolio website that shows your work at its best with starter sites, patterns, and WordPress blocks.

**Portfolio post type & taxonomies.** Manage all your projects in one place with Twentig’s portfolio post type. Build your portfolio pages in the WordPress block editor, add featured images, and organize your work with project categories and tags — just like blog posts.

**Portfolio block.** Display your projects with a powerful, easy-to-use portfolio block. Built on the Query Loop block, you can customize its query settings, layout, and style to fit your needs.

**Portfolio block patterns.** Browse a variety of patterns to showcase your projects, including grid, grid overlay, and split layouts. Choose the pattern that fits your style and apply it in one click.

**Portfolio starter sites.** Start with a professionally designed Portfolio starter site crafted for the Twentig One theme to get your portfolio up and running fast, then personalize it with our Onboarding Customizer.

### Twenty Twenty-Five and other WordPress default themes

In addition to enhanced blocks, block patterns, and portfolio tools, Twentig extends the following WordPress default themes:

#### Twenty Twenty-Five and Twenty Twenty-Four

Starter sites for the Twenty Twenty-Five theme:

* [Business](https://demo.twentig.com/tt5-business/)
* [News Blog](https://demo.twentig.com/tt5-news/)
* [Photo Blog](https://demo.twentig.com/tt5-photo/)
* [Personal Blog](https://demo.twentig.com/tt5-personal/)

Starter sites for the Twenty Twenty-Four theme:

* [Business](https://demo.twentig.com/tt4-default/)
* [Blog](https://demo.twentig.com/tt4-blog/)
* [Personal](https://demo.twentig.com/tt4-personal/)
* [Portfolio](https://demo.twentig.com/tt4-portfolio/)

#### Twenty Twenty-One and Twenty Twenty

If you prefer classic themes over block themes, Twentig offers advanced customization options for the Twenty Twenty-One and Twenty Twenty themes, along with one-click starter sites.

**Advanced theme customization.** From post grids and sidebars to sticky menus and header & footer layouts, Twentig gives you powerful ways to enhance your WordPress theme. Inside the Customizer (Appearance > Customize), you can change fonts with Google Fonts, adjust the site layout, customize global styles, edit the 404 page, and more.

**Custom page templates.** Take control of your page layout with custom templates. Remove the page title, header, or footer, set a transparent header, and use WordPress blocks to create custom hero sections, landing pages, and more.

**Starter sites.** Instead of starting from scratch, import one of Twentig’s starter sites directly from the Customizer (Appearance > Customize > Starter sites).

### Get more

* [See our quickstart guide](https://twentig.com/quickstart-guide/?utm_source=wp-repo&utm_medium=link&utm_campaign=guide) to learn the basics of using Twentig.
* [Visit our blog](https://twentig.com/blog/) for tutorials on building professional sites with the WordPress block editor.
* [Browse curated color palettes](https://twentig.com/wordpress-color-palettes/?utm_source=wp-repo&utm_medium=link&utm_campaign=color-palettes) to find beautiful color combinations for your site.
* [Subscribe to our newsletter](https://twentig.com/newsletter?utm_source=wp-repo&utm_medium=link&utm_campaign=newsletter) to receive exclusive starter sites, tips, and updates.
* [Subscribe to our YouTube channel](https://www.youtube.com/channel/UCHZglgs5eTxkpRFl2r5RsGA?sub_confirmation=1) for video tutorials.
* [Explore the best WordPress websites](https://wp.gallery) built with the block editor for inspiration.

### Enjoying Twentig?

* [Rate it on WordPress](https://wordpress.org/support/plugin/twentig/reviews/).
* [Donate](https://twentig.com/donate/) to support its development.

== Installation ==

#### Install Twentig

To install and activate Twentig:

1. Log in to your WordPress dashboard.
2. Go to Plugins > Add New.
3. Search for “Twentig”.
*Alternatively, you can click Upload Plugin to upload the plugin [.zip file](https://downloads.wordpress.org/plugin/twentig.latest-stable.zip).*
4. Click Install Now.
5. Once the installation is complete, click Activate.

#### Install the Twentig One WordPress theme

To take full advantage of Twentig and the WordPress block editor, we recommend using Twentig One, our modern and powerful block theme built for Full Site Editing.

Visit our [Get Started](https://twentig.com/get-started/?dl=1) page to download and install Twentig One.

#### After installation

With Twentig One, as well as the Twenty Twenty-Five and Twenty Twenty-Four themes, you can import a pre-made starter site to get started quickly. To do so, open the Twentig dashboard, go to the Starter sites tab, and import the starter site of your choice.

To learn more, see our [quickstart guide](https://twentig.com/quickstart-guide/).

== Frequently Asked Questions ==

= Can I try Twentig before installing it on my live website? =

Yes. You can try Twentig on [our playground](https://twentig.com/playground/?utm_source=wp-repo&utm_medium=link&utm_campaign=playground) — no install required.

Or, if you use WordPress Studio — a free desktop app for local WordPress development — you can launch a local site with Twentig pre-installed in [one click](https://wp.com/open?deep_link=add-site%3Fblueprint_url%3Dhttps%253A%252F%252Fraw.githubusercontent.com%252Ftwentig%252Fblueprints%252Fmain%252Fstudio-setup.json).

= What are the requirements for using Twentig? =

We recommend using the latest version of WordPress to get the most out of Twentig and the block editor.

= Does Twentig work with any theme? =

Twentig works with any theme, especially WordPress block themes. However, for the best experience, we recommend using [Twentig One](https://twentig.com/twentig-one/), our modern and powerful block theme built for Full Site Editing.

= Is Twentig easy to use? =

Yes. With Twentig, no coding or design skills are required. Instead of building from scratch, you can import a ready-made starter site. You can also customize your theme and WordPress blocks in a few clicks and use responsive block patterns to create professional-looking pages with ease. Moreover, Twentig doesn’t clutter the block editor with additional blocks — it enhances existing WordPress core blocks instead.

= Do you have a quickstart guide? =

Yes, you can find our quickstart guide on [our website](https://twentig.com/quickstart-guide?utm_source=wp-repo&utm_medium=link&utm_campaign=guide).

= How to import a starter site? =

With Twentig One, as well as the Twenty Twenty-Five and Twenty Twenty-Four themes, you can use a pre-built starter site to jumpstart your website design. Just open the Twentig dashboard, go to the Starter sites tab, and import the starter site you like. It only takes a few seconds.

= How to create a WordPress portfolio? =

If you’re using the Twentig One theme, the easiest way is to import the Portfolio starter site. In your WordPress dashboard, go to "Twentig > Starter sites" and select the Portfolio starter site. This will import a ready-to-use, customizable portfolio website with all the pages you need to showcase your work. You can then manage and create your projects from the Portfolio screen.

Otherwise, you can enable the portfolio feature under "Twentig > Settings". Then, from the Portfolio screen, you can manage and create your projects. Finally, create a page in the block editor and insert the Portfolio block to build your portfolio index.

= How to insert a pre-designed block pattern? =

To insert a block pattern:

1. In the WordPress block editor, place your cursor where you want to insert the block pattern.
2. Click the + icon to open the block inserter.
3. Open the Patterns tab.
4. Browse the categories and click the pattern you want to insert, or drag and drop it into your content.

= Is Twentig RTL-ready? =

Yes, Twentig supports RTL (right-to-left) languages.

= Should I install the Gutenberg plugin? =

No, we do not recommend using the Gutenberg plugin on a production site, as it includes experimental features that may be unstable. For that reason, Twentig is not fully compatible with the Gutenberg plugin.

== Screenshots ==

1. **Import a starter site.** Launch faster by importing a responsive starter site that gives your website a professional look.
2. **Customize your starter site.** Easily personalize your header, footer, homepage, blog, colors, and typography with our Onboarding Customizer.
3. **Create your online portfolio.** Twentig gives you all the portfolio features you need to showcase your work in the best light.
4. **Manage your projects.** Add, edit, and organize your work from Twentig’s dedicated Portfolio screen.
5. **Build with block patterns.** Choose from hundreds of ready-to-use patterns to create beautiful pages in no time.
6. **Customize WordPress blocks.** Enhance existing blocks with extra settings like animations and image shapes in the block editor.
7. **Take the Gallery block to the next level.** Transform your galleries into justified, slider, or carousel layouts with one click.
8. **Make your container blocks clickable.** Turn Group and Cover blocks into fully clickable elements and add hover effects.
9. **Personalize your buttons.** Add icons to make your buttons more engaging and open videos in a lightbox.

== Changelog ==

= 2.0.3 =
Release date: July 2, 2026

* Fix: Prevents unnecessary re-renders related to shadow presets in the block editor (props @ateliercommodore).

= 2.0.2 =
Release date: June 17, 2026

* New: Adds chat, location, event, shopping bag, and store icons to the Button block.
* New: Adds a setting to disable content-only pattern editing on WordPress 7.0+.
* New: Adds new Gallery patterns.
* Enhancement: Updates patterns to use the Grid block instead of the Columns block where appropriate.

= 2.0.1 =
Release date: May 19, 2026

* New: Adds a color palette paste feature for the Twentig One theme in the Site Editor and Onboarding Customizer.
* Enhancement: Improves Customizer previews by opening the relevant Blog or Portfolio page when those sections are expanded.
* Enhancement: On WordPress 7.0+, migrates Twentig's visibility controls to the core viewport-based block visibility option.
* Enhancement: Hides the core Gallery Aspect Ratio setting when using the justified layout.
* Enhancement: Preserves custom font sizes on Navigation submenu links when the parent Navigation block also has a font size.
* Fix: Adjusts CSS selectors for Navigation hover and active styles to make them work with custom navigation overlays.

= 2.0 =
Release date: March 19, 2026

Twentig 2.0 introduces 4 starter sites (Business, Portfolio, Blog, Personal) for the new Twentig One block theme, along with a powerful yet simple Onboarding Customizer. It also brings new customization options to WordPress blocks like Gallery, Button, Group, Video, Accordion, Query Loop, and more.

* New: Adds 4 starter sites for the Twentig One theme with an Onboarding Customizer.
* New: Adds a starter site file importer for the Twentig One theme.
* New: Adds carousel and justified layouts to the Gallery block.
* New: Adds a video lightbox option to the Button block.
* New: Adds icon options to the Button block.
* New: Adds hover options (text color, background color, border color, shadow) to the Group block.
* New: Adds filters to the Query Loop block for single posts (exclude current post, related by category or tag).
* New: Adds advanced controls to the Video block (autoplay when in view, minimal controls).
* New: Adds icon options to the Accordion block.
* New: Adds extra class layouts (alt columns, alt spacer, alt grid) to the Post Template block.
* New: Adds an option to the Post Excerpt block to display only the manual excerpt.
* New: Adds extra classes to the Submenu block (rounded, shadow, no-border, align right).
* New: Adds style to the Navigation Link block for external links.
* New: Adds spacing support to the Query Pagination block.
* Enhancement: Refactors block settings controls to use ToolsPanel instead of PanelBody.
* Fix: Removes the core/latest-posts featured image sizes override for classic themes (props Muhammad Yudha).

= 1.9.7 =
Release date: January 15, 2026

* New: Prompts users to install the WordPress Importer plugin for starter sites instead of bundling it.
* Code Quality: Improves code quality and WordPress coding standards compliance.

= 1.9.6 =
Release date: December 5, 2025

* Fix: Reverts custom footer code for classic themes for compatibility with third-party plugins, including The Events Calendar.

= 1.9.5 =
Release date: December 1, 2025

* Enhancement: Adds post format support for Portfolio when supported by the theme.
* Code Quality: Deprecates Twentig’s Gallery aspect ratio setting in favor of the new core option.
* Code Quality: Organizes block PHP code into individual files.
* Compatibility: Makes the Customizer options for the classic themes compatible with WordPress 6.9.

= 1.9.4 =
Release date: June 4, 2025

* New: Adds an option to display captions for the Post Featured Image block.
* New: Adds CSS classes for balanced text wrapping (tw-text-balance) and pretty text wrapping (tw-text-pretty).

= 1.9.3 =
Release date: April 7, 2025

* Enhancement: Marks compatibility with WordPress 6.8.
* Fix: Adjusts CSS for the Cover block’s stretched link.
* Fix: Adjusts CSS for the Navigation block’s accent color style.
* Fix: Adjusts CSS for the Navigation block’s thick border style (props @sebastjava).

= 1.9.2 =
Release date: February 11, 2025

* Fix: Restores the Posts per Page, Max Pages, and Offset controls for the Portfolio block (props @fgiband).

= 1.9.1 =
Release date: January 27, 2025

* Enhancement: Uses media queries range syntax for visibility classes (props @sebastjava).
* Enhancement: Adjusts the CSS selector to apply overflow:hidden more selectively to groups with border-radius.
* Enhancement: Adds Bluesky and X icons for the Twenty Twenty-One and Twenty Twenty themes.
* Enhancement: Updates content and site icon link in the Twentig dashboard (props @pmmueller).
* Fix: Updates starter site URLs and content.
* Fix: Updates animation range control.

= 1.9 =
Release date: November 14, 2024

Twentig 1.9 introduces powerful features to supercharge Twenty Twenty-Five, the new default WordPress theme. Now, instead of designing from scratch, you can easily import a customizable starter site. Choose from [Business](https://demo.twentig.com/tt5-business/), [News Blog](https://demo.twentig.com/tt5-news/), [Photo Blog](https://demo.twentig.com/tt5-photo/), or [Personal Blog](https://demo.twentig.com/tt5-personal/) starter sites to jumpstart your site.

* New: Adds four starter sites for Twenty Twenty-Five.
* Enhancement: Makes block patterns compatible with Twenty Twenty-Five.
* Enhancement: Adjusts code for compatibility with WordPress 6.7.
* Code Quality: Deprecates Twentig’s Group shadow setting.

[See changelog for all versions](https://twentig.com/twentig-changelog).
