Visualforce Developer Guide

Introducing Visualforce
Tools for Visualforce Development
Getting a Quick Start with Visualforce
Customizing the Appearance and Output of Visualforce Pages
Standard Controllers
Standard List Controllers
Custom Controllers and Controller Extensions
Advanced Examples
Overriding Buttons, Links, and Tabs with Visualforce
Overriding Tabs Using a Standard List Controller
Defining Custom Buttons and Links for Visualforce
Adding Custom List Buttons using Standard List Controllers
Displaying Record Types
Using Static Resources
Creating and Using Custom Components
Dynamic Visualforce Bindings
Dynamic Visualforce Components
Integrating Email with Visualforce
Visualforce Charting
Creating Maps with Visualforce
Render Flows with Visualforce
Templating with Visualforce
Developing for Mobile Devices
Adding Visualforce to a Force.com AppExchange App
Using JavaScript in Visualforce Pages
Best Practices
Standard Component Reference
Appendices
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Overriding Buttons, Links, and Tabs with Visualforce

You can override the behavior of standard buttons on record detail pages. You can also override the tab home page that displays when a user clicks a standard, custom, or external object tab.

To override a standard button or a tab home page:
  1. Click Edit next to the button or tab home page you want to override.
  2. Pick Visualforce Page as an override type.
  3. Select the Visualforce page you want to run when users click the button or tab.
    When overriding buttons with a Visualforce page, you must use the standard controller for the object on which the button appears. For example, if you want to use a page to override the Edit button on accounts, the page markup must include the standardController="Account" attribute on the <apex:page> tag: 
    1<apex:page standardController="Account">
2<!-- page content here -->
3</apex:page>

    When overriding tabs with a Visualforce page, you can select only Visualforce pages that use the standard list controller for that tab, pages with a custom controller, or pages with no controller.

    When overriding lists with a Visualforce page, you can select only Visualforce pages that use a standard list controller.

    When overriding the New button with a Visualforce page, you have the option to skip the record type selection page. If you choose this option, new records you create aren’t forwarded to the record type selection page. Salesforce assumes that your Visualforce page is already handling record types.

    Use a controller extension when you need to add extra functionality to Visualforce page that you are using as an override.

    Tip

  4. Optionally, enter any comments to note the reason for this change.
  5. Click Save.

To remove an override:

  1. From the appropriate object’s management settings, go to Buttons, Links, and Actions.
  2. Click Edit next to the override.
  3. Select No Override (default behavior).
  4. Click OK.