Supported and Unsupported Migrations
When converting between an old version of the UComm NC State Theme and the new Gutenberg version, certain modules support automatic conversion to block counterparts, while other data may need to be manually converted.
Supported Conversions
The following blocks and shortcodes are fully supported for automatic conversion in the new Gutenberg NC State Theme. Once a page or post is converted to blocks (via the Convert to Blocks mechanism), the following shortcodes and modules will automatically convert into their new block counterparts.
| Module Name | Block Name |
|---|---|
| Text | Headings, Paragraphs, Lists |
| Events | Events |
| Fact | Big Fact |
| Image Divider | Media Divider |
| Mini Story | Mini Story |
| Linked List | Linked List |
| Featured Content | Featured Content |
| Highlight (component) | Mini Story |
| Shortcode Name | Block Name |
|---|---|
| Button | Button |
| Giving Form | Giving Form |
| Pullquote | Pullquote |
| Marketing Quote | Testimonial |
| Spotlight Box | Spotlight Box |
| Toggles | Accordion |
| Video Image | Video Image |
Unsupported, But Coming Soon
The following blocks do not currently have automatic conversions available, as the block equivalent version is planned but still unreleased. In these cases, you may choose to leave the content as-is (will not render) until the equivalent block is available for conversion, or select an alternative block to manually copy/paste the old data into. This decision will likely be determined by how critical the old content in these modules was to the purpose of your page.
| Module Name | Block Name |
|---|---|
| News (RSS feed) | Coming soon |
| Link Blocks (component) | Coming soon |
Automatic Conversion Unsupported
The following blocks and shortcodes were previously supported in older versions of the NC State Theme, but do not have a direct equivalent in the new Gutenberg version. All content previously entered in these blocks is preserved, but will not appear as it used to.
Each instance where these modules and shortcodes were used should be evaluated on a case by case basis during site review and manually migrated to another block (or deleted). The Content Converter Block will help you find these unsupported bits of content and provide a copy/paste friendly version of the data to aid in the process.
Listed below are potential alternative blocks to explore.
| Module Name | Potential Alternative Blocks |
|---|---|
| CTA Icon Block | Fact List |
| HTML | No Equivalency |
| Calendar | Events |
| Photo Gallery | Instagram Feed |
| Single Tweet | No Equivalency |
| Storybook | Mini Story, Featured Content, Headings/Paragraphs |
| Featured Content (Component version) | Featured Content |
| Newswire Feed | Automated Posts, Featured Content |
| Shortcode Name | Potential Alternative Blocks |
|---|---|
| Box | Spotlight Box |
| Responsive Iframe | No Equivalency |
| Retina Image | Image |
| Social Box | No Equivalency |
For more information about how to handle unsupported migration content, see the full Content Converter Block topic.
Need help?
Have questions? Feel free to reach out with any questions or concerns at go.ncsu.edu/ucomm-dev-request.