Documentation
Feedback
Guides

Back To Top Button

The back-to-top-button component is a button that redirects users to the top of the page when clicked.

{"base64":"  ","img":{"width":1586,"height":713,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":56394,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/vtex-store-components-backtotopbutton-0.png"}}

Back To Top Button rendered as a text button

{"base64":"  ","img":{"width":1574,"height":683,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":1687084,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/vtex-store-components-backtotopbutton-1.png"}}

Back To Top Button rendered as a caret icon

Configuration

  1. Import the vtex.store-components app to your theme's dependencies in the manifest.json file as in the following example:

_10
"dependencies": {
_10
"vtex.store-components": "3.x"
_10
}

  1. Add the back-to-top-button block into a store template of your choice. In the example, it will be added to the home page:

_10
"store.home": {
_10
"blocks": [
_10
+ "back-to-top-button",
_10
]
_10
},

  1. Then, declare the back-to-top-button block using the props stated in the Props table. For example:

_10
"store.home": {
_10
"blocks": [
_10
"back-to-top-button",
_10
]
_10
},
_10
+ "back-to-top-button":{
_10
+ "props":{
_10
+ "displayThreshold": 800,
_10
+ }
_10
+ }

Props

Prop nameTypeDescriptionDefault Value
displayenumDefines the component rendering. Possible values are: button to display a button with a Back To Top label text or caret-icon to display just an icon.button
displayThresholdnumberDefines the window Y pixel in which the button will be displayed.600

Customization

To apply CSS customizations in this and other blocks, follow the Using CSS handles for store customization guide.

CSS Handles
backToTopButtonActive
backToTopButtonContainer
backToTopButtonHidden
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page