> This page is for Developer. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.bigcommerce.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server. # PayPal Smart Buttons PayPal Smart Buttons are available on Cornerstone versions 2.6.0+ for merchants who have **PayPal powered by Braintree** or **PayPal Express Checkout** enabled on their store. Theme developers can enable Smart Buttons on a custom Stencil theme by adding the required settings to the config.json file. Merchants will have the ability to customize some style aspects of the PayPal payment buttons at checkout using Page Builder for stores that have PayPal powered by Braintree or PayPal Express Checkout enabled. To make PayPal Smart Buttons customizable with Page Builder, a theme developer will need to make its customization properties available by adding its schema to the schema.json file. ## Enable Smart Buttons on Your Stencil Theme Smart Buttons are included on Cornerstone versions 2.6.0+. If your theme does not already include Smart Buttons, append the `paymentbuttons` settings to the *Settings* object within your config.json file. See the code sample below. **`Addition of paymentbuttons to 'settings' object config.json`** ```json title="Addition of paymentbuttons to 'settings' object config.json" showLineNumbers={false} "settings": { "..." "color_badge_product_sale_badges": "#007dc6", "color_text_product_sale_badges": "#ffffff", "color_hover_product_sale_badges": "#000000", "restrict_to_login": false, "swatch_option_size": "22x22", "social_icon_placement_top": false, "social_icon_placement_bottom": "bottom_none", "geotrust_ssl_common_name": "", "geotrust_ssl_seal_size": "M", "navigation_design": "simple", "price_ranges": true, "pdp-price-label": "", "pdp-sale-price-label": "Now:", "pdp-non-sale-price-label": "Was:", "pdp-retail-price-label": "MSRP:", "paymentbuttons-paypal-layout": "horizontal", "paymentbuttons-paypal-color": "gold", "paymentbuttons-paypal-shape": "pill", "paymentbuttons-paypal-size": "small", "paymentbuttons-paypal-label": "checkout", "paymentbuttons-paypal-tagline": true, "paymentbuttons-paypal-fundingicons": false }, ``` > **Note** > > #### Page Builder Customization > > Adding the above keys to the `config.json` file will enable Smart Buttons on a Stencil theme, however, the merchant will **not** be able to customize button styles with Page Builder unless setting configurations are added to the `schema.json` file. ## Enabling Smart Buttons Customization via Page Builder Merchants who enable PayPal powered by Braintree and PayPal Express Checkout can also customize PayPal Smart Buttons via Page Builder. As a theme developer, you can enable PayPal Smart Buttons customization via [Page Builder](https://github.com/bigcommerce/cornerstone/blob/master/schema.json), by appending the following object to the schema.json file: **`Filename=`** ```json Filename="Addition to schema.json file in order to enable Page Builder customization schema.json" showLineNumbers={false} { "name": "Payment Buttons", "enable": "smartButtons", "settings": [ { "type": "checkbox", "label": "Show Paypal tagline", "force_reload": true, "id": "paymentbuttons-paypal-tagline" }, { "type": "checkbox", "label": "Show funding icons", "force_reload": true, "id": "paymentbuttons-paypal-fundingicons" }, { "type": "select", "label": "Button color", "id": "paymentbuttons-paypal-color", "force_reload": true, "options": [ { "value": "gold", "label": "Gold" }, { "value": "blue", "label": "Blue" }, { "value": "silver", "label": "Silver" }, { "value": "black", "label": "Black" } ] }, { "type": "select", "label": "Button shape", "id": "paymentbuttons-paypal-shape", "force_reload": true, "options": [ { "value": "pill", "label": "Pill" }, { "value": "rect", "label": "Rectangle" } ] }, { "type": "select", "label": "Button size", "id": "paymentbuttons-paypal-size", "force_reload": true, "options": [ { "value": "small", "label": "Small" }, { "value": "medium", "label": "Medium" }, { "value": "large", "label": "Large" }, { "value": "responsive", "label": "Responsive" } ] }, { "type": "select", "label": "Button content", "id": "paymentbuttons-paypal-label", "force_reload": true, "options": [ { "value": "checkout", "label": "Paypal Checkout" }, { "value": "pay", "label": "Pay with Paypal" }, { "value": "buynow", "label": "Buy Now" }, { "value": "paypal", "label": "Paypal" } ] }, { "type": "select", "label": "Display style", "id": "paymentbuttons-paypal-layout", "force_reload": true, "options": [ { "value": "horizontal", "label": "Show buttons horizontally" }, { "value": "vertical", "label": "Show buttons vertically" } ] ``` > **Note** > > #### Mutually exclusive options > > Some customization options are mutually exclusive, meaning when used in combination with other customization options, the smart button will completely fail to render on the page. > All mutually exclusive options are tied to the layout setting `vertical.` If your layout setting is `vertical,` take note of the following customization **restrictions**: > > * If you have a layout setting of `vertical`, you **can not** have a button size of `small`. > * If you have a layout setting of `vertical`, you **can not** customize the `branding` of the button. > * If you have a layout setting of `vertical`, you **can not** customize the `tagline` of the button. > * If you have a layout setting of `vertical`, you **can not** customize the `funding icons` settings. ## Resources ### Related Articles * [PayPal Checkout Customization](https://developer.paypal.com/docs/checkout/) (PayPal)