learn.microsoft.com Open in urlscan Pro
2a02:26f0:3100:1a4::3544  Public Scan

Submitted URL: https://ywnjb.mojopowertsinctech.com/ppsecure/post.srf
Effective URL: https://learn.microsoft.com/en-us/office/dev/add-ins/testing/clear-cache
Submission: On February 21 via api from US — Scanned from DE

Form analysis 3 forms found in the DOM

Name: nav-bar-search-formGET /en-us/search/

<form class="nav-bar-search-form" method="GET" name="nav-bar-search-form" role="search" id="nav-bar-search-form" aria-label="Search" action="/en-us/search/">
  <div class="autocomplete" data-bi-name="autocomplete"><!---->
    <div class="field-body control ">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-search-input" data-test-id="site-search-input" class="autocomplete-input input input-sm
						
						" type="search" name="terms" aria-expanded="false" aria-owns="ax-67-listbox" aria-controls="ax-67-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-search-input-description" placeholder="Search" pattern=".*">
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--site-search-input-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-67-listbox" data-test-id="site-search-input-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
  <!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
  <button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
  <input name="category" hidden="" value="">
</form>

Name: nav-bar-search-formGET /en-us/search/

<form class="nav-bar-search-form" method="GET" name="nav-bar-search-form" role="search" id="nav-bar-search-form-desktop" aria-label="Search" action="/en-us/search/">
  <div class="autocomplete" data-bi-name="autocomplete"><!---->
    <div class="field-body control has-icons-left">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-search-input-desktop" data-test-id="site-search-input-desktop" class="autocomplete-input input input-sm
						control has-icons-left
						" type="search" name="terms" aria-expanded="false" aria-owns="ax-68-listbox" aria-controls="ax-68-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-search-input-desktop-description" placeholder="Search"
        pattern=".*">
      <span aria-hidden="true" class="icon is-small is-left">
        <span class="has-text-primary docon docon-search"></span>
      </span>
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--site-search-input-desktop-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-68-listbox" data-test-id="site-search-input-desktop-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
  <!-- mobile safari will not dispatch submit event unless there's a submit button that is not display:none -->
  <button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button>
  <input name="category" hidden="" value="">
</form>

javascript:

<form action="javascript:" role="search" aria-label="Search" class="margin-bottom-xxs"><label class="visually-hidden" for="ax-76">Search</label>
  <div class="autocomplete display-block" data-bi-name="autocomplete"><!---->
    <div class="field-body control has-icons-left">
      <input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="ax-76" data-test-id="ax-76" class="autocomplete-input input input-sm
						control has-icons-left
						width-full" type="text" aria-expanded="false" aria-owns="ax-77-listbox" aria-controls="ax-77-listbox" aria-activedescendant="" aria-describedby="ms--ax-76-description" placeholder="Filter by title" pattern=".*">
      <span aria-hidden="true" class="icon is-small is-left">
        <span class="has-text-primary docon docon-filter-settings"></span>
      </span>
      <span aria-hidden="true" class="autocomplete-loader loader has-text-primary " hidden=""></span>
      <span hidden="" id="ms--ax-76-description"> Suggestions will filter as you type </span>
    </div>
    <ul role="listbox" id="ax-77-listbox" data-test-id="ax-76-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden="">
    </ul>
    <!---->
  </div>
</form>

Text Content

Skip to main content

We use optional cookies to improve your experience on our websites, such as
through social media connections, and to display personalized advertising based
on your online activity. If you reject optional cookies, only cookies necessary
to provide you the services will be used. You may change your selection by
clicking “Manage Cookies” at the bottom of the page. Privacy Statement
Third-Party Cookies

Accept Reject Manage cookies

This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security
updates, and technical support.

Download Microsoft Edge More info about Internet Explorer and Microsoft Edge

Documentation
Global navigation
 * Learn
   
 * Documentation
   
 * Training
   
 * Credentials
   
 * Q&A
   
 * Code Samples
   
 * Assessments
   
 * Shows
   
 * More
     
   * Documentation
     
   * Training
     
   * Credentials
     
   * Q&A
     
   * Code Samples
     
   * Assessments
     
   * Shows
     
   

Suggestions will filter as you type
Suggestions will filter as you type
Search
Sign in

 * Profile
 * Settings

Sign out
Office Add-ins
   
 * Guides
     
   * Beginners
     
   * Transition from VSTO
     
   
 * Office applications
     
   * Excel
     
   * OneNote
     
   * Outlook
     
   * PowerPoint
     
   * Project
     
   * Visio
     
   * Word
     
   
 * Resources
     
   * Office Dev Center
     
   * Blog
     
   * Samples
     
   * Tools
     
   * Videos
     
   * Community Calls
     
   * Developer Program
     
   * Support
     
   * All Resources
     
   
 * More
     
   * Guides
       
     * Beginners
       
     * Transition from VSTO
       
     
   * Office applications
       
     * Excel
       
     * OneNote
       
     * Outlook
       
     * PowerPoint
       
     * Project
       
     * Visio
       
     * Word
       
     
   * Resources
       
     * Office Dev Center
       
     * Blog
       
     * Samples
       
     * Tools
       
     * Videos
       
     * Community Calls
       
     * Developer Program
       
     * Support
       
     * All Resources
       
     
   

 1. Free account

Table of contents Exit focus mode

Search
Suggestions will filter as you type
 * Office Add-ins Documentation
 * About Office Add-ins
 * Get started
 * Development lifecycle
   * Lifecycle overview
   * Plan
   * Develop
   * Test and debug
     * Test Office Add-ins
     * Debug Office Add-ins
     * Windows
     * Web browser
     * iPad and Mac
     * Clear the Office cache
     * Debug with runtime logging
     * Debug a function command with a non-shared runtime
     * Debug the initialize and onReady functions
     * Errors
     * Performance
     * Unit testing
     * Usability testing
     * Validate an add-in's manifest
   * Publish
 * Excel
 * OneNote
 * Outlook
 * PowerPoint
 * Project
 * Visio
 * Word
 * Resources
 * API reference
 * Manifest reference
 * Requirement sets

Download PDF
    
 1. Learn
    
    
 2. Microsoft 365
    
    
 3. Office Add-ins
    

    
 1. Learn
    
    
 2. Microsoft 365
    
    
 3. Office Add-ins
    

Read in English Add
Table of contents Read in English Add Edit Print

Twitter LinkedIn Facebook Email
Table of contents


CLEAR THE OFFICE CACHE

 * Article
 * 03/14/2023
 * 9 contributors

Feedback



IN THIS ARTICLE

    
 1. Clear the Office cache on Windows
    
 2. Clear the Office cache on Mac
    
 3. Clear the Office cache on iOS
    
 4. See also
    

To remove an add-in that you've previously sideloaded on Windows, Mac, or iOS,
you need to clear the Office cache on your computer.

Additionally, if you make changes to your add-in's manifest (for example, update
file names of icons or text of add-in commands), you should clear the Office
cache and then re-sideload the add-in using an updated manifest. Doing so allows
Office to render the add-in as it's described by the updated manifest.

Note

To remove a sideloaded add-in from Excel, OneNote, PowerPoint, or Word on the
web, see Sideload Office Add-ins in Office on the web for testing: Remove a
sideloaded add-in.


CLEAR THE OFFICE CACHE ON WINDOWS

There are three ways to clear the Office cache on a Windows computer:
automatically, manually, and using the Microsoft Edge developer tools. The
methods are described in the following subsections.


AUTOMATICALLY

This method is recommended for add-in development computers. If your Office on
Windows version is 2108 or later, the following steps configure the Office cache
to be cleared the next time Office is reopened.

Note

The automatic method is not supported for Outlook.

 1. From the ribbon of any Office host except Outlook, navigate to File >
    Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs.
 2. Select the checkbox Next time Office starts, clear all previously-started
    web add-ins cache.


MANUALLY

The manual method for Excel, Word, and PowerPoint is different from Outlook.

MANUALLY CLEAR THE CACHE IN EXCEL, WORD, AND POWERPOINT

To remove all sideloaded add-ins from Excel, Word, and PowerPoint, delete the
contents of the following folder.

Copy


%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\


If the following folder exists, delete its contents too.

Copy


%userprofile%\AppData\Local\Packages\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AC\#!123\INetCache\


MANUALLY CLEAR THE CACHE IN OUTLOOK

To remove a sideloaded add-in from Outlook, use the steps outlined in Sideload
Outlook add-ins for testing to find the add-in in the Custom add-ins section of
the dialog box that lists your installed add-ins. Choose the ellipsis (...) for
the add-in and then choose Remove to remove that specific add-in.

If this add-in removal doesn't work, then delete the contents of the Wef folder
as noted previously for Excel, Word, and PowerPoint.

If your Outlook add-in uses the Unified manifest for Microsoft 365 (preview),
also delete the following folder.

Copy


%userprofile%\AppData\Local\Microsoft\Outlook\HubAppFileCache



USING THE MICROSOFT EDGE DEVELOPER TOOLS

To clear the Office cache on Windows 10 when the add-in is running in Microsoft
Edge, you can use the Microsoft Edge DevTools.

Tip

If you only want the sideloaded add-in to reflect recent changes to its HTML or
JavaScript source files, you shouldn't need to clear the cache. Instead, just
put focus in the add-in's task pane (by clicking anywhere within the task pane)
and then press Ctrl+F5 to reload the add-in.

Note

To clear the Office cache using the following steps, your add-in must have a
task pane. If your add-in is a UI-less add-in -- for example, one that uses the
on-send feature -- you'll need to add a task pane to your add-in that uses the
same domain for SourceLocation, before you can use the following steps to clear
the cache.

 1. Install the Microsoft Edge DevTools.

 2. Open your add-in in the Office client.

 3. Run the Microsoft Edge DevTools.

 4. In the Microsoft Edge DevTools, open the Local tab. Your add-in will be
    listed by its name.

 5. Select the add-in name to attach the debugger to your add-in. A new
    Microsoft Edge DevTools window will open when the debugger attaches to your
    add-in.

 6. On the Network tab of the new window, select Clear cache.
    
    

 7. If completing these steps doesn't produce the desired result, try selecting
    Always refresh from server.
    
    


CLEAR THE OFFICE CACHE ON MAC

Add-ins are often cached in Office on Mac for performance reasons. Normally, the
cache is cleared by reloading the add-in. If more than one add-in exists in the
same document, the process of automatically clearing the cache on reload might
not be reliable.


USE THE PERSONALITY MENU TO CLEAR THE CACHE

You can clear the cache by using the personality menu of any task pane add-in.
However, because the personality menu isn't supported in Outlook add-ins, you
can try the option to clear the cache manually if you're using Outlook.

 * Choose the personality menu. Then choose Clear Web Cache.
   
   Note
   
   You must run macOS Version 10.13.6 or later to see the personality menu.
   
   


CLEAR THE CACHE MANUALLY

You can also clear the cache manually by deleting the contents of the
~/Library/Containers/com.Microsoft.OsfWebHost/Data/ folder. Look for this folder
via terminal.

Note

If that folder doesn't exist, check for the following folders via terminal and
if found, delete the contents of the folder.

 * ~/Library/Containers/com.microsoft.{host}/Data/Library/Caches/ where {host}
   is the Office application (e.g., Excel)
 * ~/Library/Containers/com.microsoft.{host}/Data/Library/Application
   Support/Microsoft/Office/16.0/Wef/ where {host} is the Office application
   (e.g., Excel)
 * ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Caches/com.microsoft.Office365ServiceV2/
 * ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Library/Caches/com.microsoft.Office365ServiceV2/

To look for these folders via Finder, you must set Finder to show hidden files.
Finder displays the folders inside the Containers directory by product name,
such as Microsoft Excel instead of com.microsoft.Excel.


CLEAR THE OFFICE CACHE ON IOS

To clear the Office cache on iOS, call window.location.reload(true) from
JavaScript in the add-in to force a reload. Alternatively, reinstall Office.


SEE ALSO

 * Troubleshoot development errors with Office Add-ins
 * Debug add-ins using developer tools for Internet Explorer
 * Debug add-ins using developer tools for Edge Legacy
 * Debug add-ins using developer tools in Microsoft Edge (Chromium-based)
 * Debug your add-in with runtime logging
 * Sideload Office Add-ins for testing
 * Office Add-ins manifest
 * Validate an Office Add-in's manifest





FEEDBACK

Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the
feedback mechanism for content and replacing it with a new feedback system. For
more information see: https://aka.ms/ContentUserFeedback.

Submit and view feedback for

This product This page
View all page feedback

--------------------------------------------------------------------------------


ADDITIONAL RESOURCES



--------------------------------------------------------------------------------

Training

Module

Introduction to Office client customization with add-ins - Training

Learn how to customize and extend Office applications including Word, Excel, and
Outlook with Office Add-ins



English (United States)
California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices
Theme
 * Light
 * Dark
 * High contrast

 * Manage cookies
 * Previous Versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2024


ADDITIONAL RESOURCES



--------------------------------------------------------------------------------

Training

Module

Introduction to Office client customization with add-ins - Training

Learn how to customize and extend Office applications including Word, Excel, and
Outlook with Office Add-ins




IN THIS ARTICLE



English (United States)
California Consumer Privacy Act (CCPA) Opt-Out Icon Your Privacy Choices
Theme
 * Light
 * Dark
 * High contrast

 * Manage cookies
 * Previous Versions
 * Blog
 * Contribute
 * Privacy
 * Terms of Use
 * Trademarks
 * © Microsoft 2024