Creating Your device Page

Page Layout

  • Start a new page by clicking here.
    • If a device page already exists for your device, you shouldn't create a new one. Simply send us an email, and we'll flag the existing page so you can work on it.
  • Select "Device" from the list of options.
  • Enter your device name in the Title field.
    • The device name should exactly match what appears on the white iFixit label on the device. If you didn't get your device from iFixit, the name should be the same as what appears on the manufacturer's website or in official documentation (owner's manual, etc.)
    • If your device is known by more than one official name, stick with the most common one (Google Trends can be helpful here). Alternate model names/numbers can go in the summary (see below).
    • Do NOT include the device type or generic terms such as “laptop,” “cell phone,” etc.
    • Be sure to spell and capitalize your device name properly or your replacement guides will not link correctly.
  • Upload a picture of the device by clicking on the camera icon in the panel on the right-hand side of the page. The device page picture is the first thing users will notice when they navigate to your device page, so it's important that you take a quality photo.
    • Take the picture with the device against a solid white background that is well-lit, with the camera in landscape orientation.
    • Keep your pictures as large as possible in terms of resolution. If a picture is 4000 x 3000 pixels in size, so be it! We love large images.
    • If you're using a DSLR or other camera that captures images in an aspect ratio other than 4:3, you’ll need to crop your photos to 4:3.
    • The most important thing to remember is to take your own device page picture, rather than taking one from an online image search.
    • Please do NOT use Photoshop to remove photo backgrounds. Your backgrounds don’t have to be perfectly white; a nice uncluttered background is less distracting than one that has been crudely cut out. Even if you really, really know what you’re doing, your time is better spent on other parts of the project.
    • If you're working on a preexisting device page that already has a photo, you should check with us to see whether a new photo is needed. Just drop us an email!
  • Enter a short, descriptive summary. The summary should be 1-2 sentences, and should give the most basic identifying information about the device. Remember that summaries are used in search results, so include key words or phrases you think your readers might search for when looking for help. This is also a good place to include alternate model names/numbers, if any.
  • Please do not include a table of contents—it's helpful on longer, text-heavy wikis like the troubleshooting page, but it's not needed for your device page.
  • Add the Troubleshooting, Background and Identification, and Additional Information headers and their content in the main text box. To create a heading in wiki syntax, simply enclose a word or phrase in double equal signs (e.g. == Troubleshooting ==). Follow the format outlined in this example device page.
    • Troubleshooting This section should be a single sentence linking to the troubleshooting page you created in Milestone 1.
    • Background and Identification This section should include one or two paragraphs of info on the device (such as its major features/components, release date, known failure modes, any manufacturer recalls, etc.) and how to identify the device (including how to tell it apart from similar models).
      • This, like all of your work, should be written completely in your own words. Although you may find websites that have great descriptions of your device, do not copy and paste these descriptions into your device page, as this is plagiarism. Of course, you’re free to use these websites for reference (don’t forget to credit the source).
    • Additional Information This section should include at least three helpful links to the best online resources for the device. You can link to any helpful source of information, such as other replacement guides, the device’s Wikipedia page, the manufacturer’s device page, product reviews, etc.

The only sections of your device page you need to create manually are Troubleshooting, Background and Identification, and Additional Information. Do not create any Guides, Parts, Support Questions, or Tools sections—these sections will be added to your device page automatically when you create the additional content (just remember to keep the spelling of your device consistent). In addition, some groups may choose to manually create Upgrades and/or Specifications sections; this can be helpful if it's appropriate for your device, but it's not required.