vc_row Shortcode
The vc_row shortcode renders the row component.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Usage
[vc_row]
Content
[/vc_row]
Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
row_title |
— | String unless stated otherwise | This title is visible only in the admin area and helps site editors differentiate rows. |
full_width |
— | container, full_width, only_content |
Choose the width behavior for the row and its content. Only content removes the row wrapper, so the remaining row settings and column wrappers do not apply. This is useful for carefully designed reusable blocks. |
full_height |
— | yes |
If checked row will be set to full height. |
vertical_align |
— | String unless stated otherwise | Controls the vertical alignment and column height. |
horizontal_scroll |
— | yes |
Keeps columns on one line by adding flex-nowrap and enables horizontal scrolling with of-x-scroll on the rendered .row. |
horizontal_scroll_behavior |
native |
native, scroll, hover |
Selects native scrolling, horizontal movement with vertical page scroll, or pointer-hover movement. Requires horizontal_scroll="yes". |
parallax |
— | content-moving |
Add parallax type background for row. |
border_width |
— | String unless stated otherwise | Controls the border width. |
border_color |
— | String unless stated otherwise | Controls the border color. |
border_style |
— | solid, dotted, dashed, double, groove, ridge, inset, outset |
Controls the border style. |
next_section_arrow |
— | yes |
Add an arrow to go to next section. |
scroll_to_next_section_border_color |
— | String unless stated otherwise | Next section border color. Available when next_section_arrow is yes. |
scroll_to_next_section_icon |
— | String unless stated otherwise | Choose scroll to next section icon. Available when next_section_arrow is yes. |
scroll_to_next_section_icon_color |
— | String unless stated otherwise | Next section icon color. Available when next_section_arrow is yes. |
bg_color |
— | String unless stated otherwise | Choose background color. |
bg_img_url |
— | String unless stated otherwise | Choose image from media library. |
bg_img_url_size |
full-original-ratio |
Any registered WordPress image-size slug | Selects the generated size used for the main background image. |
bg_img_loading |
lazy |
lazy, eager |
Controls both desktop and mobile background images. Lazy loading requires enabling Advanced > Lazy Load in the theme settings. |
bg_img_url_mobile |
— | String unless stated otherwise | Choose mobile background image from media library. |
bg_img |
— | String unless stated otherwise | Controls the bg_img. |
bg_split |
— | left, right |
Limit the background image, background video, and overlay to the left or right half of the parent width while keeping content inside its container. The background color is not split. |
bg_split_mobile |
— | above, below |
Controls the background position on mobile. |
animated_bg_loop |
— | yes |
If checked, background image will be animated. |
animated_bg_loop_direction |
— | left, right, top, down |
Choose the loop direction. Available when animated_bg_loop is yes. |
animated_bg_loop_speed |
50 |
Number | Controls the loop speed. Available when animated_bg_loop is yes. |
video_bg |
— | yes |
If checked, video will be used as row background. |
video_type |
— | vimeo, self-hosted |
Choose the video source. Available conditionally according to video_bg. |
video_youtube_url |
— | String unless stated otherwise | Add YouTube link. Example: https://www.youtube.com/watch?v=##########. Available conditionally according to video_type. |
video_vimeo_url |
— | String unless stated otherwise | Add Vimeo link. Example: https://vimeo.com/##########. Available when video_type is vimeo. |
video_thumbnail_image |
— | String unless stated otherwise | Add a thumbnail while video is loading. Available conditionally according to video_bg. |
video_thumbnail_loading |
lazy |
lazy, high |
Choose whether the video thumbnail should lazy load or be fetched with high priority. Lazy loading requires enabling Advanced > Lazy Load in the theme settings. Available conditionally according to video_bg. |
video_start_after_interaction |
— | yes |
Delays player creation until the first pointer movement or action, touch, key press, wheel movement, or scroll. Off-screen videos continue to wait until they approach the viewport. Available conditionally according to video_bg. |
video_mp4_url |
— | HTTPS MP4 URL or Pomatio Video Hosting logical URL | Add a self-hosted MP4 link or paste the logical URL copied from Media → Videos. A Pomatio Video Hosting logical URL uses the standard progressive output generated for every new video; Scroll is not required. Jarallax consumes the temporary signed MP4 without loading Video.js or storing a permanent CloudFront address. Available when video_type is self-hosted. |
video_webm_url |
— | String unless stated otherwise | Add video link. Example: https://your-domain.com/##########.webm. Available when video_type is self-hosted. |
video_ogv_url |
— | String unless stated otherwise | Add video link. Example: https://your-domain.com/##########.ogv. Available when video_type is self-hosted. |
bg_slider |
— | yes |
If checked you will be able to show a background image slider. |
bg_slider_images |
— | String unless stated otherwise | Select the images to be displayed as background slideshow. Available when bg_slider is yes. |
slider_pause_time |
1000 |
Number | Specifies the time the slider will be stopped (in milliseconds). Available when bg_slider is yes. |
transition_type |
— | slide_transition, fade_transition |
Choose whether to slide or fade between slides. Available when bg_slider is yes. |
slider_animation_speed |
0.1 |
Number | Specifies the speed at which the slide will move. A lower value means lower speed. Available when bg_slider is yes. |
slider_cells_loop |
— | yes |
If checked, infinite loop will be allowed. Available when bg_slider is yes. |
overlay |
— | none, one_color_overlay, gradient_overlay |
Add an overlay. |
one_color_overlay |
— | String unless stated otherwise | Choose overlay color. Available when overlay is one_color_overlay. |
gradient_color_1 |
— | String unless stated otherwise | Choose first color for gradient. Available when overlay is gradient_overlay. |
gradient_color_2 |
— | String unless stated otherwise | Choose second color for gradient. Available when overlay is gradient_overlay. |
gradient_orientation |
— | bottom_top, bottom_right, left_right, top_right, top_bottom, right_bottom, right_left, bottom_left |
Select gradient orientation. Available when overlay is gradient_overlay. |
change_opacity |
— | Number | Select the opacity level (The higher the percentage, the lower the visibility of the background). Available when overlay is one_color_overlay or gradient_overlay. |
sticky_row |
— | yes |
Make current row sticky. |
viewport_class |
— | yes |
Toggle class depending on whether it is in the viewport or not. |
padding_width |
— | String unless stated otherwise | Controls the padding_width. |
device_visibility |
— | String unless stated otherwise | Applies the selected responsive visibility rule. |
role_visibility |
— | String unless stated otherwise | Controls the role based visibility. |
purchased_visibility |
— | String unless stated otherwise | Controls the visibility based on purchased products. |
z_index |
— | 0, 1, 2, 3, 4, 5, 999 |
Force the z-index value for this element (z-index defines the order of overlapping HTML elements). |
el_id |
— | Valid unique HTML ID | Enter section ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Horizontal scroll behavior
[vc_row horizontal_scroll="yes" horizontal_scroll_behavior="scroll"]
[vc_column width="1/2"]First panel[/vc_column]
[vc_column width="1/2"]Second panel[/vc_column]
[vc_column width="1/2"]Third panel[/vc_column]
[/vc_row]
All modes preserve the native flex-nowrap of-x-scroll row. The scroll and
hover modes also expose data-pom-horizontal-scroll on that row and request
the shared horizontal-row script. Missing or unsupported behavior values keep
native scrolling; behavior has no effect when horizontal scrolling is disabled
or Only content removes the row.
See Choose horizontal row scrolling for exact editor choices, keyboard behavior, responsive limits and verification.
Enclosed content
Content between the opening and closing tags is processed as WordPress shortcode content. Keep the parent/child structure shown by the visual builder so nested components receive the context they expect.
Verification
Inspect vc_row at every layout breakpoint and confirm its child content keeps a logical source and visual order. When horizontal scrolling is enabled, confirm the rendered .row contains flex-nowrap of-x-scroll and can scroll to every column without changing source order. Pay particular attention to row_title and full_width.