Open Bug 1997140 Opened 5 months ago Updated 1 month ago

Update about:profiles support documentation with migration information [Product version pending]

Categories

(support.mozilla.org :: Knowledge Base Content, task)

Product:
support.mozilla.org
Component:
Knowledge Base Content
Type:
task

Tracking

(Not tracked)

Status:
ASSIGNED

People

(Reporter: mossop, Assigned: ffloare)

References

Details

Attachments

(2 files)

Screen Recording 2025-11-07 at 08.14.47.mp4
935.46 KB, video/mp4
Details
Screenshot 2025-11-13 at 14.06.29.png
828.28 KB, image/png
Details

Did you check out the steps and FAQs for submitting requests to the CX content team? (yes or no)? YES

Content access restriction: Is the content restricted to staff or under embargo (yes or no)? NO

Product (ensure to select only one product for each ticket. If your request involves multiple products, file an individual Bugzilla for each)

Choose one below and delete others. [REQUIRED]
Firefox for Desktop (Windows)
Firefox for Desktop (macOS)
Firefox for Desktop (Linux)

Select the type of request.

Choose one or more below and delete others. [REQUIRED]
KB content update

Please summarize the request, emphasizing any user-facing changes. Include historical context or background information if it helps users understand the new features or changes. [REQUIRED]

Bug 1996240 adds a new button to the about:profiles page allowing a user to migrate profiles listed there to the new profile system.

##Are the user-facing changes mentioned above for the production release, or is the feature/change experimental/ beta? (Production, Experimental or Beta) The change has not yet landed but will ship on the trains to release

Are the new features or changes region-specific? Are they going to be released in a gradual rollout? No

Please indicate if this is an on- or off-train release: On-train

What is the anticipated release date? December 9

Does the content need to be published prior to the release date? Nightly and beta users make use of the old profiles system so even though this ships to release in 146 the earlier this can be published the better.

Does the content need to be localized in any languages outside of EN-US? If yes, please indicate which languages. Whatever we normally translate content into.

Please include any related JIRA/Github/Bugzilla tickets, documentation, demos or practical use cases.

Please include links to any design assets, visuals, figma files, etc. There are no design assets.

Please add instructions for testing that will enable us to replicate the expected product behavior.

  1. Open about:profiles
  2. If you don't have an additional profile you want to migrate then create a new profile.
  3. Click the profile's migrate button

Does the content need approval before publishing? If yes, identify the one approver responsible for this task.

See Also: → 1996240
Assignee: nobody → ffloare

I've been looking around trying to replicate this on Firefox Developer, but I can't see the profile migration button. Dave, can you provide me with a screenshot?

Flags: needinfo?(dtownsend)

Bug 1996240 hasn't landed yet. Here is a screencast of the current behaviour of the patch

Flags: needinfo?(dtownsend)

As you can see from the screencast the confirmation step includes a learn more link. It is currently linking to https://support.mozilla.org/en-US/kb/profile-management but we may want to change that to point to wherever we document this functionality.

(In reply to Dave Townsend [:mossop] from comment #4)

As you can see from the screencast the confirmation step includes a learn more link. It is currently linking to https://support.mozilla.org/en-US/kb/profile-management but we may want to change that to point to wherever we document this functionality.

I see. I am thinking that this one should be more accurate: https://support.mozilla.org/en-US/kb/profile-manager-create-remove-switch-firefox-profiles

What do you think?

(In reply to Flavius Floare from comment #5)

(In reply to Dave Townsend [:mossop] from comment #4)

As you can see from the screencast the confirmation step includes a learn more link. It is currently linking to https://support.mozilla.org/en-US/kb/profile-management but we may want to change that to point to wherever we document this functionality.

I see. I am thinking that this one should be more accurate: https://support.mozilla.org/en-US/kb/profile-manager-create-remove-switch-firefox-profiles

What do you think?

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

(In reply to Dave Townsend [:mossop] from comment #6)

(In reply to Flavius Floare from comment #5)

(In reply to Dave Townsend [:mossop] from comment #4)

As you can see from the screencast the confirmation step includes a learn more link. It is currently linking to https://support.mozilla.org/en-US/kb/profile-management but we may want to change that to point to wherever we document this functionality.

I see. I am thinking that this one should be more accurate: https://support.mozilla.org/en-US/kb/profile-manager-create-remove-switch-firefox-profiles

What do you think?

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Thank you. I'll come back to you with a draft ASAP.

(In reply to Flavius Floare from comment #7)

(In reply to Dave Townsend [:mossop] from comment #6)

(In reply to Flavius Floare from comment #5)

(In reply to Dave Townsend [:mossop] from comment #4)

As you can see from the screencast the confirmation step includes a learn more link. It is currently linking to https://support.mozilla.org/en-US/kb/profile-management but we may want to change that to point to wherever we document this functionality.

I see. I am thinking that this one should be more accurate: https://support.mozilla.org/en-US/kb/profile-manager-create-remove-switch-firefox-profiles

What do you think?

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Thank you. I'll come back to you with a draft ASAP.

Here is the draft: https://docs.google.com/document/d/1EHFRhAarZi1ZKTLvIOWb5YU2ZZatPei6ZhrZB9ULdSk/edit?tab=t.0

I tagged you in it.

(In reply to Flavius Floare from comment #8)

(In reply to Flavius Floare from comment #7)

(In reply to Dave Townsend [:mossop] from comment #6)

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Can you tell me what I need to use as the in-product link stub for this ahead of time? I can't land the patch without it.

Flags: needinfo?(ffloare)

(In reply to Dave Townsend [:mossop] from comment #9)

(In reply to Flavius Floare from comment #8)

(In reply to Flavius Floare from comment #7)

(In reply to Dave Townsend [:mossop] from comment #6)

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Can you tell me what I need to use as the in-product link stub for this ahead of time? I can't land the patch without it.

Sure, do you need an in-product link for the whole article, or just for the Migrate section within the article?

Flags: needinfo?(ffloare)

Updated screenshot of about:profiles with new button

(In reply to Flavius Floare from comment #10)

(In reply to Dave Townsend [:mossop] from comment #9)

(In reply to Flavius Floare from comment #8)

(In reply to Flavius Floare from comment #7)

(In reply to Dave Townsend [:mossop] from comment #6)

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Can you tell me what I need to use as the in-product link stub for this ahead of time? I can't land the patch without it.

Sure, do you need an in-product link for the whole article, or just for the Migrate section within the article?

Just the migrate section

(In reply to Dave Townsend [:mossop] from comment #12)

(In reply to Flavius Floare from comment #10)

(In reply to Dave Townsend [:mossop] from comment #9)

(In reply to Flavius Floare from comment #8)

(In reply to Flavius Floare from comment #7)

(In reply to Dave Townsend [:mossop] from comment #6)

Yes I think so. That doesn't seem to be linkable from our in-product links, I forget how we make that work

We simply turn into an in-product link. But we'll do that after we have the draft, and it's reviewed and ready to go. I think we can even anchor it directly to the Migrate section in the article.

Can you tell me what I need to use as the in-product link stub for this ahead of time? I can't land the patch without it.

Sure, do you need an in-product link for the whole article, or just for the Migrate section within the article?

Just the migrate section

Dave, I have it here: https://support.mozilla.org/1/firefox/%7Bversion%7D/%7Bplatform%7D/en-US/move-to-profile-menu

However, please be aware that the anchor won't work until the update is added to the KB article.

Flavius, You have a pending Nov 28, 2025 revision to the Profile Manager article "For 146 release". Can you add {for fx146} markup for the new content once Version 146 is added to the version picker? (See bug 2000072). Alternatively, could you add a note that the new "Move to profile menu" feature is for fx146 and above?
See comment 18 below (quote) This is not going to go out in 146

Flags: needinfo?(ffloare)

(In reply to Dave Townsend [:mossop] from comment #0)

Bug 1996240 adds a new button to the about:profiles page allowing a user to migrate profiles listed there to the new profile system.

Are the user-facing changes mentioned above for the production release, or is the feature/change experimental/ beta? (Production, Experimental or Beta) The change has not yet landed but will ship on the trains to release

Please indicate if this is an on- or off-train release: On-train

What is the anticipated release date? December 9

Is this still on track for the Firefox version 146 release?

The "Move to profile menu" button in about:profiles isn't available in the latest Firefox 146 beta and bug 1996240 is still open.

Flags: needinfo?(dtownsend)

(In reply to Alice Wyman from comment #15)

(In reply to Dave Townsend [:mossop] from comment #0)

Bug 1996240 adds a new button to the about:profiles page allowing a user to migrate profiles listed there to the new profile system.

Are the user-facing changes mentioned above for the production release, or is the feature/change experimental/ beta? (Production, Experimental or Beta) The change has not yet landed but will ship on the trains to release

Please indicate if this is an on- or off-train release: On-train

What is the anticipated release date? December 9

Is this still on track for the Firefox version 146 release?

The "Move to profile menu" button in about:profiles isn't available in the latest Firefox 146 beta and bug 1996240 is still open.

No, that work is currently waiting on a way to handle experimentation data.

Dave, to double-check: Is this still scheduled for December 9?

Flags: needinfo?(ffloare)

(In reply to Flavius Floare from comment #17)

Dave, to double-check: Is this still scheduled for December 9?

Sorry looks like I failed to comment in the bug already. This is not going to go out in 146.

Flags: needinfo?(dtownsend)

:mossop can you update the title to the correct version, relman searches for these to ensure they are live on rollout date.

Flags: needinfo?(dtownsend)
Summary: Update about:profiles support documentation with migration information [Product V146] → Update about:profiles support documentation with migration information [Product version pending]
Flags: needinfo?(dtownsend)
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Creator:
Created:
Updated:
Size: