Agency

Import the Agency design and it brings blocks and content types of its own, on top of the main Canvas library. Read this page when you are working on a site built from Agency and meet a block you cannot find in the main reference.

These items stay registered on every site so that content you have already imported keeps rendering, and they appear in the block inserter only where the design is in use.

Blocks this design adds

Agency Works

canvas-core/agency-works

Display Portfolio projects as an agency-style carousel or grid, or render a single project page (attributes, contact CTA, related projects). In the block inserter it is named Canvas Agency Works.

Select the block on a page and its own settings open in the sidebar, in the panels below:

The Agency Works settings in the block editor sidebar

Layout

  • LayoutDefaultPortfolio Grid

    Which part of the design this block draws: a grid or a sliding row of projects, or one of the three pieces that build a single project page. The single pieces render nothing anywhere else.

    ChoicesPortfolio GridPortfolio CarouselSingle Work - AttributesSingle Work - Contact CTASingle Work - Back + Related

Display

  • ColumnsDefault3 Columns

    How many projects sit side by side in the grid on a wide screen. Narrower screens step down on their own, and the carousel takes its count from the carousel settings instead.

    Choices2 Columns3 Columns4 Columns

  • Grid Wrapper ClassesDefaultportfolio row gutter-20

    Classes on the cards-grid wrapper.

  • Carousel Wrapper ClassesDefaultowl-carousel portfolio-carousel carousel-widget

    Classes on the carousel wrapper. carousel-widget lets the theme auto-initialise it.

  • Wrapper IDDefaultEmpty

    Wrapper id (the home carousel uses "oc-portfolio"). Empty = no id.

  • Portfolio Page SlugDefaultportfolio

    Slug of the portfolio landing page. The single layouts resolve it to a portable permalink for the category eyebrow and the "Back to Portfolio" button. Empty = no link.

  • Contact Page SlugDefaultcontact

    Slug of the page the single-cta button links to. Resolved to a portable permalink so the link is correct on any install / import. Empty = no button.

  • CTA Button TextDefaultStart a Project

    Wording on the button that invites a visitor to get in touch from a project page. Leave it empty and no button appears.

  • Back Button TextDefaultBack to Portfolio

    Wording on the button that returns a visitor from a project page to the portfolio listing. Leave it empty and no button appears.

  • Related HeadingDefaultMore Works

    Heading above the row of other projects at the foot of a project page. Leave it empty to show the projects with no heading.

Query

  • ItemsDefault0

    0 shows all works.

  • Order ByDefaultMenu Order

    What decides the sequence projects appear in: the order you arranged them in, when each was published, or the project name.

    ChoicesMenu OrderDateTitle

  • OrderDefaultAscending

    Whether that sequence runs forwards or backwards. With Order By set to Date, Descending puts the newest project first.

    ChoicesAscendingDescending

Carousel

  • Items (base)Default0

    Fallback item count for every breakpoint that sets none of its own. 0 leaves it unset.

    Shown when Layout is "Portfolio Carousel"

  • Items (XS)Default1

    Slides visible on screens narrower than 576 pixels. 0 falls back to Items (base).

    Shown when Layout is "Portfolio Carousel"

  • Items (SM)Default2

    Slides visible from 576 pixels up. 0 repeats the count from the breakpoint below.

    Shown when Layout is "Portfolio Carousel"

  • Items (MD)Default3

    Slides visible from 768 pixels up. 0 repeats the count from the breakpoint below.

    Shown when Layout is "Portfolio Carousel"

  • Items (LG)Default4

    Slides visible from 992 pixels up. 0 repeats the count from the breakpoint below.

    Shown when Layout is "Portfolio Carousel"

  • Items (XL)Default4

    Slides visible from 1200 pixels up, including the widest screens. 0 repeats the count from the breakpoint below.

    Shown when Layout is "Portfolio Carousel"

  • Item Gap (px)Default1

    Space between one slide and the next, in pixels.

    Shown when Layout is "Portfolio Carousel"

  • Show ArrowsDefaultOn

    Show the previous and next arrows beside the slides.

    Shown when Layout is "Portfolio Carousel"

  • Arrows Always VisibleDefaultOff

    Keep the arrows on screen instead of revealing them when the pointer enters the carousel.

    Shown when Layout is "Portfolio Carousel"

  • Show DotsDefaultOff

    Show the row of dots below the slides, one per page.

    Shown when Layout is "Portfolio Carousel"

  • Autoplay (ms)Default0

    Milliseconds between slides. 0 disables autoplay.

    Shown when Layout is "Portfolio Carousel"

  • LoopDefaultOn

    Run the slides in an endless cycle, so the last one is followed by the first. Off stops at each end.

    Shown when Layout is "Portfolio Carousel"

  • Transition SpeedDefault250

    Milliseconds per slide transition.

    Shown when Layout is "Portfolio Carousel"

  • Centre Active SlideDefaultOff

    Keeps the active slide in the middle of the stage.

    Shown when Layout is "Portfolio Carousel"

  • Stage PaddingDefault0

    Pixels of the neighbouring slides left visible at each edge. 0 leaves it unset.

    Shown when Layout is "Portfolio Carousel"

  • Animate InDefaultEmpty

    Animation class applied to the incoming slide. Empty uses a plain slide.

    Shown when Layout is "Portfolio Carousel"

  • Animate OutDefaultEmpty

    Animation class applied to the outgoing slide. Empty uses a plain slide.

    Shown when Layout is "Portfolio Carousel"

Was this page helpful?