[[content-edit]] === Editing Content (((Content,editing))) ==== Goal Learn how to update existing content. ==== Prerequisite knowledge Basic familiarity with using a browser. Basic familiarity with the concept of content types. Familiarity with <>. These instructions only apply to editing content that forms individual pages (as opposed to blocks, taxonomy terms, or views headers or footers, etc). In all but the rarest of circumstances, you must be logged into the site in question to be able edit content. @todo link to appropriate instructions on editing other content. @todo How to make this more friendly to new Drupal users. @todo create a basic description of content types ==== Steps .Locate the content to be edited ..Edit in place There are several ways to locate content. The first is that you are on a page where you are viewing the content in question. Above the content should be several buttons among which will be "Edit". Click on "Edit". ..Edit via the content list The other common way to locate a piece of content to edit is to click on the "Content" button in the Admin menu bar to view a list of all the content on the site. You can and use the filters to locate the content you want to edit. An advantage of editing via this content list is that when you save a piece of content, Drupal will return you to this list so you can edit another piece of content. This is useful when you have to edit a large number of items. Below we'll cover how to make batch edits to content using the options on this content list page. .Edit the piece of content. Once you pick the "Edit" link/button, your browser should load the content in an editor form. As introduced in the <>, you can change the title, body text and other fields here. On the right sidebar (or below the content on a mobile device), you will see some vertical tabs that offer other tasks related to the content. // draw a box around just the vertical tabs on the editing form page image:images/content-edit_vertical-tabs.png[vertical tabs list] ..Revisions Revisions are a useful tool for managing the history of edits of a piece of content and to be able to revert to a previous version of the content. If you check the "create a new revision" a new copy of the content will be created upon saving. (Once saved you will see a new tab labeled "Revisions".) @todo need managing revisions documentation. ..Menu Settings As described in the <>, you can edit the menu link title, create a description (that will appear when the user is hovering over the link, the menu, and the position within the menu) ..Comment Settings If commenting is enabled on the site as well as for this particular content type, this is where you can close or re-open commenting. NOTE: Once a piece of content has been created, changing commenting defaults for the content type do not affect the status of commenting on any content of that type that has already been created. (So if you have 50 blog posts already and find commenting is a problem, you can change the default for the "blog post" content type, but, absent advanced editing options, you must manually close commenting on each extant blog post.) ..URL Path Settings As introduced in <>, you can edit the path to your content here using letters, numbers, hyphens and underscores. ..Authoring Information You can change the author, date and time the content was "created" here. Only authors that already exist as explained in the <<_users_roles_and_permissions,users section>> can be assigned as author of a piece of content. ..Promotion Options As introduced in <>, you can change whether a piece of content should be promoted to the front page or whether the content's position will always appear at the top of lists regardless of other sorting rules. NOTE: While a default installation of Drupal will use these for the front page aggregation of, content, these options will have no effect if they have not been enabled in the various content lists defined in views and other tools. @todo link to views overview. @todo explanation of front page default aggregation configuration. .Saving Content At the bottom of the editor, there is a blue button with a triangle on right side. // Comment explaining how to regenerate the image, for future contributors. image:images/content-edit_save-options.png[Save button with options, preview and delete buttons] This means that the button has options. If you click on the triangle, you will see that you can choose to save and publish the content, or save and unpublish the content. Unpublished content is no longer visible to those users (including the anonymous user) who are not allowed to view unpublished content (see the <<_users_roles_and_permissions,users section>> for details.) You can also preview the content here and also delete it. NOTE: deleting content also deletes all revisions, so there is no recovery for deleted content. .Making Batch Changes Certain features of content can be edited in batch such as whether a collection of content items are published or not, sticky at the top of lists, promoted to the front page. This is done in the content page (eg. yoursite.com/admin/content). You can use the filters to narrow down your list, and then check the items you want to manipulate. Then you can use the drop-down menu with the label "With selection". NOTE: as with the delete option on the editing form, deletions are permanent and cannot be undone. With advanced configurations, you can create triggers using modules like https://www.drupal.org/project/rules[Rules] that are called when a piece of content is saved. If you want to apply the triggers to a bunch of content you already created, you can do this by using the "Save Content" option in the drop-down menu. ==== Follow-on tasks <> <> ==== Additional resources