The Blog
Canvas renders the blog from two sets of decisions: what an archive of posts looks like, and what a single post shows. Both are made once, site-wide, in the Blog tab of Theme Options, and both can be overridden per page and per post where one place needs to differ. Read this page when you are setting the blog up, or when one page needs a layout the rest of the site does not use.
How To Choose The Archive Layout
Starting screenCanvasTheme Options, the Blog tab.
The Blog Layout setting is the big decision: standard stacked entries, a grid, small thumbnails, list cards, masonry or a timeline. Pick the layout first, because the settings below it adapt to the choice, with Columns appearing for the grid and masonry layouts. Then work down the Archive group: the featured image and its size, which meta items each card shows, the excerpt and its length, the read more link, and the Pagination Type, which is also where the load more button and infinite scroll live.
The archive can carry a sidebar. Turn on Show Sidebar and choose its Sidebar Position, and edit the sidebar's content as a template part, which is covered in Widget Areas In Canvas.
How To Configure Single Posts
The same tab's Single group makes the equivalent decisions for a post's own page: the Single Post Layout, its sidebar, the featured image, the meta line, and the row of extras below the content, the reading bar, tags, share buttons, post navigation, the author box, related posts and comments. Each extra is a toggle, so trimming a post page down is a matter of switching off what you do not want.
How To Override The Layout In One Place
Two side-column meta boxes carry the per-place overrides, and both leave every field empty by default, which means follow Theme Options:
- On a page, the Blog Layout Override box sets that page's Blog Layout, Columns, Sidebar and Sidebar Position. This is how a page that lists posts can run a grid while the main blog stays standard. The layout list here also includes a custom choice driven by a post card template, for a card design of your own.
- On a post, the same box sets that post's Single Post Layout, Sidebar and Sidebar Position, with a custom choice driven by a post single template.
Posts additionally carry a Post Media box, which decides what the post shows in its entry card and at the top of the single post. Auto follows the post's Format panel, and every other choice pins a medium explicitly: a video or audio embed, a gallery slider, a thumbnail grid, a quotation, a link or a status card. Cards read it when the archive's Card Media setting is on Post Format Media.
Listing Posts On A Page You Compose
The Canvas Posts category in the block inserter holds the loop parts. The Blog Archive Loop block renders the main archive loop inside a template, the Canvas Posts block lists posts anywhere with its own query, and the remaining blocks are the pieces of a single post, its title, image, meta, share row and related posts, for building a custom post design.
Pitfalls
Columns is missing from the Blog tab. It appears only when Blog Layout is the grid or masonry choice. The other layouts define their own geometry.
The sidebar shows on posts but not on the archive. The archive and single sidebars are separate settings with different defaults: the archive's Show Sidebar starts off, the single post's starts on. Set each where it lives.
A page override seems ignored. Empty means inherit. Check the page's Blog Layout Override box actually holds a value, because a box full of global defaults changes nothing by design.
Cards ignore the Post Media box. Cards read format media only when the archive's Card Media setting is Post Format Media. On Featured Image, the box still styles the top of the single post but the card stays a featured image.
Every Setting
Both groups of the Blog tab are listed below, generated from the product, so they are current by construction:
Blog LayoutDefaultStandard
Choose how blog posts are displayed on archive pages.
ChoicesStandardGridSmall ThumbsSmall Thumbs AltList - Overlay CardList - HorizontalList - MinimalMasonryTimeline
ColumnsDefault3 Columns
Number of columns for grid and masonry layouts.
Choices2 Columns3 Columns4 Columns5 Columns6 ColumnsShown when Blog Layout is "Grid" or "Masonry"
Columns (Custom Layout)Default3 Columns
Number of columns used when a page sets its own Blog Layout to Custom. Unlike the grid layouts, a single column is allowed.
Choices1 Column2 Columns3 Columns4 Columns5 Columns6 Columns
Show SidebarDefaultOff
Display a sidebar on blog archive pages. Edit its content under Appearance → Editor → Patterns → Template Parts → Sidebar.
Sidebar PositionDefaultRight
Choose sidebar position on archive pages.
ChoicesRightLeftBoth SidebarsShown when Show Sidebar is on
Show Featured ImageDefaultOn
Display featured images on blog archive pages.
Card MediaDefaultFeatured Image
Post Format Media draws each card from the post itself: a video or audio embed, a gallery slider, a thumbnail grid, a pull-quote, a link or a status card, as set in the post's own Post Media box. Posts with no format media fall back to their featured image.
ChoicesFeatured ImagePost Format MediaShown when Show Featured Image is on and Blog Layout is "Standard" or "Grid" or "Small Thumbs" or "Small Thumbs Alt" or "List - Overlay Card" or "List - Horizontal" or "Masonry" or "Timeline"
Image SizeDefaultLarge
Choose the image size for blog archive entries.
ChoicesThumbnailMediumMedium LargeLargeFullShown when Show Featured Image is on and Blog Layout is "Standard" or "Grid"
Show Post TitleDefaultOn
Display the post title on blog archive entries.
Show Post MetaDefaultOn
Display post metadata (date, author, categories, comments).
Meta ItemsDefaulta preset list of 3 rows
Choose which meta items to display on archive entries. Drag and drop to rearrange.
ChoicesDateAuthorCategoriesCommentsReading TimeShown when Show Post Meta is on
Show ExcerptDefaultOn
Display the post excerpt on blog archive entries.
Excerpt LengthDefault
55Number of words to show in post excerpts.
Shown when Show Excerpt is on
Show Read More LinkDefaultOn
Display "Read More" link after excerpts.
Read More TextDefault
Read MoreText for the "Read More" link.
Shown when Show Read More Link is on
Pagination TypeDefaultNumeric
Choose how to navigate between blog pages.
ChoicesDefault (Previous/Next)NumericLoad More ButtonInfinite Scroll
Single Post LayoutDefaultDefault (Sidebar)
Choose the layout variant for single blog posts.
ChoicesDefault (Sidebar)Full WidthSmall Image (Inline)Split (Hero Above)
Show SidebarDefaultOn
Display sidebar on single blog post pages.
Shown when Single Post Layout is "Default (Sidebar)" or "Split (Hero Above)"
Sidebar PositionDefaultRight
Choose sidebar position on single posts.
ChoicesRightLeftBoth SidebarsShown when Show Sidebar is on
Show Featured ImageDefaultOn
Display featured image on single blog posts.
Image SizeDefaultFull
Choose the image size for single post featured images.
ChoicesMedium LargeLargeFullShown when Show Featured Image is on and Single Post Layout is "Default (Sidebar)" or "Full Width" or "Split (Hero Above)"
Show Post MetaDefaultOn
Display post metadata on single posts.
Meta ItemsDefaulta preset list of 4 rows
Choose which meta items to display on single posts. Drag and drop to rearrange.
ChoicesDateAuthorCategoriesCommentsReading TimeShown when Show Post Meta is on
Show Reading BarDefaultOn
Display reading time, font sizer, print, and share buttons below content.
Show TagsDefaultOn
Display post tags below content.
Show Share ButtonsDefaultOn
Display social sharing buttons on single posts.
Share NetworksDefaulta preset list of 5 rows
Choose which social networks to show in the share section.
ChoicesFacebookTwitter / XLinkedInPinterestEmailShown when Show Share Buttons is on
Show Post NavigationDefaultOn
Display previous/next post navigation.
Show Author InfoDefaultOn
Display author information box on single posts.
Show Related PostsDefaultOn
Display related posts section on single posts.
Related Posts CountDefault
2Number of related posts to display.
Shown when Show Related Posts is on
Related Posts ColumnsDefault2 Columns
Number of columns for related posts grid.
Choices2 Columns3 Columns4 ColumnsShown when Show Related Posts is on
Show CommentsDefaultOn
Display the comments section on single posts.
What To Read Next
- Widget Areas In Canvas, editing the sidebar the blog shows
- Blog Archive Loop and Canvas Posts, the listing blocks
