Change the appearance of a Web Part

If you are a Web page owner, you can configure Web Parts in several ways. From your Web browser, you can change Web Part properties by using the Web Part Maintenance Page. You can further configure Web Parts by using a SharePoint compatible Web design program, such as Microsoft SharePoint Designer 2010.

To learn about the Web Parts in SharePoint, see Overview of Web Parts available in SharePoint Foundation 2010, and Web Parts for views and forms in SharePoint Designer 2010.

In this article


Change Web Part properties by using the tool pane

You can change the attributes of a Web Part by assigning values to its Web Part properties. All Web Parts share a set of common properties that allow you to specify attributes for the appearance, layout, and other information. A Web Part can also have custom properties that apply only to that Web Part.

  1. On the Site Actions menu Site Actions Menu, click Edit Page.
  2. Point to the Web Part, click the down arrow, and then click Edit Web Part.
  3. The common and custom properties of the Web Part appear in the tool pane. For example, common properties you can change might include the Web Part name, size, and other layout parameters. Custom properties are those settings specific to a given Web Part.

 Note    If you are in a personal view, the Web Part developer may have limited which custom properties can be changed for that Web Part.

  1. To save your changes and close the tool pane, click OK. To view your changes without closing the tool pane, click Apply.

Top of Page Top of Page

Open and use the Web Part Maintenance Page

If you encounter problems with a Web Part or Web Part connection on a page, you can use the Web Part Maintenance Page to help isolate and fix your problem. You must have the appropriate permissions to use the Web Part Maintenance Page.

 Tip    If you are not sure which Web Part or Web Part connection is causing a problem on your Web Part Page, it is a good idea to work in a step-by-step fashion by closing one Web Part at a time and then browsing through the Web Part Page (click Go Back to My Web Part Page) to see if that fixes the problem. After you identify the problem Web Part, you can consider resetting or deleting it.

  1. Open the document library that contains the page.
  2. Point to the name of the page, click the down arrow, and then click Edit Properties.
  3. Click Open Web Part Page in maintenance view to display the Web Part Maintenance Page.

 Note    To access the Web Part Maintenance Page for a page that is not stored in a document library, such as the site home page, append Contents=1 to the end of the URL for the page.

  1. Verify that you are in the view that you want, either a personal view or shared view. If you need to switch views, do one of the following:
    • If you are in a personal view and you want to switch to a shared view, click Switch to shared view.
    • If you are in a shared view and you want to switch to a personal view, click Switch to personal view.
  2. Select one or more Web Parts, and then do one of the following:
    • To move a Web Part to the Web Part Page gallery, click Close.
    • To remove personal property values and revert to the shared property values of the Web Part, click Reset. You are prompted for confirmation before resetting a Web Part.
    • To permanently delete a Web Part from the page, click Delete. You are prompted for confirmation before deleting a Web Part.

 Note    If the Allow editing in personal view property is unchecked, a Web Part may only be deleted in a shared view.

  1. When you finish, click Go Back to Web Part Page.

 Note    You cannot use the Web Part Maintenance Page to close, reset, or delete a static Web Part (that is, a Web Part outside a Web Part zone).

To maintain a static Web Part, you must use a SharePoint-compatible Web design program

Top of Page Top of Page

Common properties of Web Parts

All Web Parts share a common set of properties that control their appearance, layout, and advanced characteristics.


 Notes 

The common Web Part properties that you see in the tool pane may be different from what is documented in this section for several reasons:
  • To see the Advanced section in the tool pane, you must have appropriate permission.
  • For a specific Web Part, a Web Part developer may have chosen not to display one or more of these common properties or may have chosen to create and display additional properties that are not listed below in the Appearance, Layout, and Advanced sections of the tool pane.
  • Some permission and property settings may disable or hide Web Part properties.

Appearance

Property Description
Title Specifies the title of the Web Part that appears in the Web Part title bar.
Height Specifies the height of the Web Part.
Width Specifies the width of the Web Part.
Chrome State Specifies whether the entire Web Part appears on the page when a user opens the page. By default, the chrome state is set to Normal and the entire Web Part appears. Only the title bar appears when the state is set to Minimized.
Chrome Type Specifies whether the title bar and border of the Web Part frame are displayed.

Layout

Property Description
Hidden

Specifies whether the Web Part is visible when a user opens the page. If the check box is selected, the Web Part is visible only when you are designing the page and has the suffix (Hidden) appended to the title.

You can hide a Web Part if you want to use it to provide data to another Web Part through a Web Part connection, but you don't want to display the Web Part.

Direction Specifies the direction of the text in the Web Part content. For example, Arabic is a right-to-left language; English and most other European languages are left-to-right languages.
Zone

Specifies the zone on the Web Part Page where the Web Part is located.

 Note    Zones on the Web Part Page are not listed in the list box when you do not have permission to modify the zone.

Zone Index

Specifies the position of the Web Part in a zone when the zone contains more than one Web Part.

To specify the order, type a positive integer in the text box.

If the Web Parts in the zone are ordered from top to bottom, a value of 0 means that the Web Part appears at the top of the zone. If the Web Parts in the zone are ordered from left to right, a value of 1 means that the Web Part appears on the left of the zone.

For example, when you add a Web Part to an empty zone that is ordered from top to bottom, the Zone Index is 0. When you add a second Web Part to the bottom of the zone, its Zone Index is 1. To move the second Web Part to the top of the zone, type 0, and then type 1 for the first Web Part.

 Note    Each Web Part in the zone must have a unique Zone Index value. Therefore, changing the Zone Index value for the current Web Part can also change the Zone Index value for other Web Parts in the zone.

Top of Page Top of Page

Advanced

Property Description
Allow Minimize Specifies whether the Web Part can be minimized.
Allow Close Specifies whether the Web Part can be removed from the Web Part Page.
Allow Hide Specifies whether the Web Part can be hidden.
Allow Zone Change Specifies whether the Web Part can be moved to a different zone.
Allow Connections Specifies whether the Web Part can participate in connections with other Web Parts.
Allow Editing in Personal View Specifies whether the Web Part properties can be modified in a personal view.
Export Mode Specifies the level of data that is permitted to be exported for this Web Part. Depending on your configuration, this setting may not be available.
Title URL Specifies the URL of a file containing additional information about the Web Part. The file is displayed in a separate browser window when you click the Web Part title.
Description Specifies the ScreenTip that appears when you rest the mouse pointer on the Web Part title or Web Part icon.
Help URL Specifies the location of a file containing Help information about the Web Part. The Help information is displayed in a separate browser window when you click the Help command on the Web Part menu.
Help Mode

Specifies how a browser will display Help content for a Web Part.

Select one of the following:

  • Modal Opens a separate browser window, if the browser has this capability. A user must close the window before returning to the Web page.
  • Modeless Opens a separate browser window, if the browser has this capability. A user does not have to close the window before returning to the Web page. This is the default value.
  • Navigate Opens the Web page in the current browser window.

 Note    Even though custom Microsoft ASP.NET Web Parts support this property, default Help topics open only in a separate browser window.

Catalog Icon Image URL Specifies the location of a file containing an image to be used as the Web Part icon in the Web Part List. The image size must be 16 by 16 pixels.
Title Icon Image URL Specifies the location of a file containing an image to be used in the Web Part title bar. The image size must be 16 by 16 pixels.
Import Error Message Specifies a message that appears if there is a problem importing the Web Part.

Top of Page Top of Page

 
 
Applies to:
SharePoint Foundation 2010 , SharePoint Online for enterprises, SharePoint Online for professionals and small businesses , SharePoint Server 2010