Custom CSS Style Guide
The Hosted Payment Page can be styled within certain parameters to match your brand. Use this page as a reference guide to how you can overwrite the standard style to fit your own.
You may modify any of the rules below, including ( in formatted order ):
Controller Classes |
Container Sizing |
Header Sizing |
Button Color and Design |
Image Sizing |
Form Field Sizing |
Table Color and Design |
To Modify a Rule:
- Log into https://my.basecommerce.com
- Navigate to your Settings
- Navigate to your Hosted Payments Page settings (this is a sub navigation item that only shows after clicking Settings)
- Create or Edit the Hosted Payment Page you would like to style
- Open CSS Customization tab
- Copy the styles from this guide to change into the custom CSS text area (making the edits that you see fit)
- Preview and save your changes
Control Classes
/* Set global properties here */ * { margin: 0; padding: 0; border-collapse:collapse; font-size: 14px; font-family: "Aktiv Grotesk", Arial, Helvetica, sans-serif; } form { margin: 0 auto; min-width: 500px; max-width: 800px; padding: 40px 40px 80px; } .hide{ display: none; } .clear{ clear: both; } .requiredColor{ color: #DA291C; } .badData{ border:solid 1px #DA291C !important; } .disabledField{ opacity: 0.5; cursor: not-allowed !important; } .floatLeft{ float:left; } .noLeftMargin { margin-left: 0 !important; } .noLeftPadding { padding-left: 0 !important; } .noTopPadding { padding-top: 0 !important; } div.modalOverlay { position: fixed; background: rgba(0,0,0,0.2); height:100vh; width: 100%; z-index: 2147483647; background-image: url( '/images/loading-animation.gif' ); background-position: 50% 50%; background-repeat: no-repeat; background-size: 50px; }
Container DIVs
/* The all parent container's sizing */ #hppContainer { position: absolute; margin: 0 auto; height: 100%; width: 100%; overflow: scroll; } .headerBlock{ background-color: #0D2240; padding: 10px 30px; border-top: 1px solid #aab1bb; border-bottom: 1px solid #aab1bb; } .informationBlock{ margin:0px 0px 30px; padding: 30px 25px; background-color: #f8f8f8; } .userInformation{ margin: 20px 0px; }
Header Tag Controls
h1{ font-size: 24px; font-family: "Gilroy", Arial, Helvetica, sans-serif; color: white; } h2{ margin: 12px 0px 5px; font-size: 21px; font-family: "Aktiv Grotesk", Arial, Helvetica, sans-serif; } h2 > b { font-size: inherit; } h4,h5{ margin:0px 0px 15px; } hr{ color: #A4A9AD; margin: 15px 0 30px; }
Button Controls
button{ margin-right: 20px; font-size: 12pt; color:#fff; background-color: #41B5E4; border: none; height: 40px; line-height: 42px; width: 150px; cursor: pointer; float: left; } button:hover{ background-color: #0D2240; } #submitButton{ width: 175px; } .cancel_button{ font-weight: normal !important; font-size: 1em !important; color: #3db5e6 !important; cursor: pointer; background:none; border:none; margin:0; padding:0; width: 100px; border: 1px solid #3db5e6; } .cancel_button:hover{ background-color: white; color: #0D2240 !important; border: 1px solid #0D2240; } .ui-dialog .ui-dialog-buttonpane button:first-child{ margin: 0 !important; } .documentLinks{ display: inline; cursor: pointer; font-size: 16px; color: #7c868f; border-bottom: 1px solid #7c868f; } .documentLinks:hover{ color: #41B5E4; border-bottom: 1px solid #41B5E4; }
Image Controls
#cardSprites img{ padding: 0px 5px 5px; height: 26px; width: auto; } #cardSprites{ margin-bottom: 15px; margin-top: 3px; background: none; width: 48%; } #merchantLogo{ height: 50px; width:auto; padding-bottom: 30px; }
Form Controls
.container_full { width: calc(100% - 10px); padding: 10px 5px; float: left; } .container_threeQuarter { width: calc(75% - 10px); padding: 10px 5px; float: left; } .container_half { width: calc(50% - 10px); padding: 10px 5px; float: left; } .container_twoThird { width: calc(66.666% - 10px); padding: 10px 5px; float: left; } .container_third { width: calc(33.333% - 10px); padding: 10px 5px; float: left; } .container_quarter { width: calc(25% - 10px); padding: 10px 5px; float: left; } /* Standard appearance settings for all text form fields */ input[type="text"] { border: 1px solid #e8e8e8; border-radius: 0px; height: 40px; width: 100%; color: #333E48; text-indent: 16px; box-sizing: border-box; padding-bottom: 0px; } input[type=text]::placeholder input[type=text]::-moz-placeholder input[type=text]::-webkit-input-placeholder input[type=text]:-ms-input-placeholder { color: #A2A9AE; font-size: 1em; } .formSelectField { width:100%; height:40px; display: block; text-align:left; border: none; border-radius: 0px; font-size: 1em; color: #7c858a; padding-left: 16px; padding-right: 50px; -webkit-appearance: none; -moz-appearance: none; text-overflow: ""; background-color: rgba(230, 231, 232, 0.5); background-image: url('/images/dropdown_arrow.png'); background-size: 40px 40px; background-repeat: no-repeat; background-position: calc(100% - 1px); } option{ padding:2px 10px; } /* Custom checkbox controls and if it's checked or not */ .checkbox_container > input[type="checkbox"] { width: 1px; height: 1px; -ms-transform: scale(0.1); /* IE */ -moz-transform: scale(0.1); /* FF */ -webkit-transform: scale(0.1); /* Safari and Chrome */ -o-transform: scale(0.1); /* Opera */ transform: scale(0.1); margin: 3px 4px; outline: none; border: none; background-color: transparent; opacity: 0.1; position: absolute; } .checkbox_container > input[type="checkbox"] + label { font-family: "Aktiv Grotesk", Arial, Helvetica, sans-serif; font-size: 16px; color: #7c858a; font-weight: normal !important; cursor: pointer; } .checkbox_container > input[type="checkbox"] + label span { display: inline-block; width: 20px; height: 20px; margin: -3px 5px 0 0; vertical-align:middle; background: #fff url('/images/checkbox.png') left top no-repeat; background-size: contain; cursor: pointer; } .checkbox_container > input[type="checkbox"]:focus + label span { -webkit-box-shadow: 0 0 5px rgba(162, 169, 174, 0.8); -moz-box-shadow: 0 0 5px rgba(162, 169, 174, 0.8); box-shadow: 0 0 5px rgba(162, 169, 174, 0.8); } .checkbox_container > input[type="checkbox"]:checked + label span { background: #fff url('/images/checkbox-selected.png') left top no-repeat; background-size:contain; } .checkbox_container > input[type="checkbox"]:checked { opacity: 0.1; } input[type="checkbox"] + label { cursor: pointer; font: inherit; font-weight: inherit; font-size: inherit; font-family: inherit; margin: inherit; opacity: 1; pointer-events: auto; position: inherit; font-weight: 100; } .radio_container > input[type="radio"] { display: none; } .radio_container > input[type="radio"] + label { font-family: "Aktiv Grotesk", Arial, Helvetica, sans-serif; font-size: 1em; color: #7c858a; opacity: 1; position: relative; margin: 0; cursor: pointer; pointer-events: initial; } .radio_container > input[type="radio"] + label span { display: inline-block; width: 18px; height: 18px; margin: -2px 5px 0 0; vertical-align:middle; background: url('/images/radio.png') left top no-repeat; background-size: contain; cursor: pointer; } .radio_container > input[type="radio"]:checked + label span { background: url('/images/radio-selected.png') left top no-repeat; background-size:contain; } textarea { resize: none; height:auto; width:100%; box-sizing: border-box; padding:10px; border: 1px solid #e8e8e8; border-radius: 0px; color: #333e48; }
Table Controls
.hppTable { width: 100%; min-width: 400px; } /* Color for the table header */ .hppTable thead{ color: #333e48; border-bottom: 1px solid #e8e8e8; font-size: 16px; } .hppTable th { height: 50px; font-weight: bold; text-align: left; } .hppTable tr{ border-bottom:1px solid #e8e8e8; } .hppTable tfoot tr { border-bottom: 0; } .hppTable tbody tr:last-child { border-bottom: 3px solid #333e48; } .hppTable tfoot tr:last-child { border-bottom: 0; } .hppTable td { padding: 15px 0; color: #333e48; text-align:left; } /* Hides the border for "total" and the total amount */ .hppTable tfoot td:nth-last-child(2) { width: 75%; text-align:right; padding-right: 30px; color: #333e48; font-weight: bold; } .hppTable tfoot td:nth-last-child(1){ border-left:none; } #hppPreTaxTotal { width: calc(100% - 20px); text-align: right; float: right; padding-right: 10px; } .totalText{ padding:8px 30px; } .totalText + td { padding: 10px 0; } .totalAmount{ text-align:right; padding: 0px 10px; } .dollarSign{ padding: 12px 10px 12px 0; float: left; } .place_to_show_message { display: none; } tfoot .place_to_show_message td:last-child { border-left: 1px solid #e8e8e8; text-align: right; }
Error Handling Controls
#headerMessageContainer { margin: 0 auto; width: 90%; padding: 0 5%; min-width: 530px; background-color: white; position: fixed; z-index: 50; transition: all .4s ease-out; } #headerMessage { margin: 30px; background-color: #DA291C; color: white; width: calc(100% - 90px); padding: 15px; vertical-align: middle; } #headerMessageContent ul { margin-left: 15px; } #exitIcon { background-image: url(/images/icon-close-white.png); background-repeat: no-repeat; background-size: 23px; background-position: top right; display: inline-block; width: 23px; height: 23px; content: ""; float: right; cursor: pointer; margin-top: -1px; } #exitIcon:hover { background-image: url(/images/icon-close-gray-dk.png); } #errorIconMessage { width: 50%; padding: 0 5px 10px 0; float: left; height: 20px; min-width: 80%; vertical-align: middle; } #errorIconMessage span { height: 100%; line-height: 20px; vertical-align: top; display: inline-block; } #errorIconMessage span:nth-child(2) { margin-top: 3.5px; } #errorIcon { background-image: url(/images/icon-alert-white.png); background-size: 18px; background-repeat: no-repeat; background-position: center bottom; display: inline-block; width: 18px; height: 18px; content: ""; margin-right: 15px; }
Placeholder Controls
.container_full label, .container_half label, .container_third label, .container_quarter label, .container_twoThird label, .container_threeQuarter label { opacity: 0; position:absolute; margin:15px 10px; font: 11px "Aktiv Grotesk", Arial, Helvetica, sans-serif; pointer-events: none; transition: all 0.1s ease-out; } .formFieldInnerLabel label{ transition: all 0.1s ease-out; position:absolute; margin:5px 17px 3px; font: 11px "Aktiv Grotesk", Arial, Helvetica, sans-serif; color:#757575; opacity: 1; } .formFieldInnerLabel input[type="text"], .formFieldInnerLabel select { font-family: "Aktiv Grotesk", Arial, Helvetica, sans-serif !important; padding: 14px 2px 0 0; height: 40px !important; box-sizing: border-box; } .formFieldInnerLabel select { padding: 14px 50px 0 13px; }